CKTIS / C#
CancellationTokenSource — vyžiadanie zrušenia a uvoľnenie prostriedkov
CancellationTokenSource spravuje kooperatívne rušenie pomocou CancellationToken. Cancel žiada o zastavenie práce, zatiaľ čo Dispose uvoľňuje prostriedky a operácie neruší.
Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
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 sprístupňuje prostredníctvom Token token, ktorý sa odovzdáva operáciám. Cancel() nastaví IsCancellationRequested na true vo všetkých kópiách tohto tokenu. Rušenie je kooperatívne: kód, ktorý token prijme, musí reagovať; samotná žiadosť vlákno násilne neukončí. Pomocou CancelAfter(...) možno naplánovať žiadosť po určenom oneskorení.
CancellationTokenSource.Dispose() uvoľňuje prostriedky, ale nežiada o zrušenie a nenahrádza čakanie na dokončenie práce. Vlastník zdroja by ho mal uvoľniť, keď ho prestane používať, napríklad pomocou using. Potom zdroj nepoužívajte. Dispose() zavolajte až po dokončení všetkých ostatných operácií s týmto zdrojom; nesmie prebiehať súčasne s nimi.
Príklad pre net10.0 prečíta stav tokenu, zavolá Cancel() a stav prečíta znova. Pri opustení bloku using sa pred záverečnou správou zavolá Dispose(). Keďže sa nepoužívajú časovače ani úlohy na pozadí, poradie výstupu je deterministické.
Príklady
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.");Výsledok
Before: False After: True Source disposed.
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.