Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

CancellationTokenSource — traženje otkazivanja i oslobađanje resursa

CancellationTokenSource upravlja suradničkim otkazivanjem putem CancellationToken. Cancel traži zaustavljanje rada, dok Dispose oslobađa resurse i ne otkazuje operacije.

Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaksa

using var source = new CancellationTokenSource();
CancellationToken token = source.Token;
source.Cancel();
// source.Dispose() is called automatically at the end of the scope.

System.Threading.CancellationTokenSource putem Token izlaže token koji se prosljeđuje operacijama. Cancel() postavlja IsCancellationRequested na true u svakoj kopiji tog tokena. Otkazivanje je suradničko: kod koji primi token mora reagirati; sam zahtjev ne prekida nit prisilno. Pomoću CancelAfter(...) može se zakazati zahtjev nakon određenog odgađanja.

CancellationTokenSource.Dispose() oslobađa resurse, ali ne traži otkazivanje i ne zamjenjuje čekanje da se rad dovrši. Vlasnik izvora trebao bi ga osloboditi kada ga prestane upotrebljavati, primjerice pomoću using. Nakon toga nemojte upotrebljavati izvor. Pozovite Dispose() tek nakon što završe sve druge operacije nad tim izvorom; ne smije se izvršavati istodobno s njima.

Primjer za net10.0 očitava stanje tokena, poziva Cancel() i ponovno očitava stanje. Pri izlasku iz bloka using poziva se Dispose() prije završne poruke. Budući da nema mjerača vremena ni pozadinskih zadataka, redoslijed izlaza je deterministički.

Primjeri

using System;
using System.Threading;

using (var source = new CancellationTokenSource())
{
    CancellationToken token = source.Token;
    Console.WriteLine($"Before: {token.IsCancellationRequested}");

    source.Cancel();

    Console.WriteLine($"After: {token.IsCancellationRequested}");
}

Console.WriteLine("Source disposed.");

Rezultat

Before: False
After: True
Source disposed.

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori