CKTIS / C#
CancellationTokenSource — vyžádání zrušení a uvolnění prostředků
CancellationTokenSource spravuje kooperativní rušení pomocí CancellationToken. Cancel žádá o zastavení práce, zatímco Dispose uvolňuje prostředky a operace neruší.
Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
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 zpřístupňuje prostřednictvím Token token, který se předává operacím. Cancel() nastaví IsCancellationRequested na true ve všech kopiích tohoto tokenu. Rušení je kooperativní: kód, který token obdrží, musí reagovat; samotná žádost vlákno násilně neukončí. Pomocí CancelAfter(...) lze naplánovat žádost po stanovené prodlevě.
CancellationTokenSource.Dispose() uvolňuje prostředky, ale nevyžaduje zrušení a nenahrazuje čekání na dokončení práce. Vlastník zdroje by jej měl uvolnit, až jej přestane používat, například pomocí using. Poté zdroj nepoužívejte. Dispose() zavolejte až po dokončení všech ostatních operací s tímto zdrojem; nesmí probíhat souběžně s nimi.
Příklad pro net10.0 přečte stav tokenu, zavolá Cancel() a přečte stav znovu. Při opuštění bloku using se před závěrečnou zprávou zavolá Dispose(). Protože se nepoužívají časovače ani úlohy na pozadí, je pořadí výstupu deterministické.
Pří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ýsledek
Before: False After: True Source disposed.
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.