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.