CKTIS / C#
CancellationTokenSource — żądanie anulowania i zwalnianie zasobów
CancellationTokenSource zarządza kooperacyjnym anulowaniem przez CancellationToken. Cancel zgłasza żądanie zatrzymania, natomiast Dispose zwalnia zasoby i nie anuluje operacji.
Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Składnia
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 udostępnia przez Token token przekazywany operacjom. Cancel() ustawia IsCancellationRequested na true we wszystkich kopiach tego tokenu. Anulowanie jest kooperacyjne: kod odbierający token musi zareagować; samo żądanie nie przerywa siłą wątku. CancelAfter(...) pozwala zaplanować żądanie po zadanym opóźnieniu.
CancellationTokenSource.Dispose() zwalnia zasoby, ale nie zgłasza żądania anulowania i nie zastępuje oczekiwania na zakończenie pracy. Właściciel źródła powinien je zwolnić po zakończeniu używania, na przykład przez using. Nie używaj potem źródła. Dispose() wolno wywołać dopiero po zakończeniu wszystkich innych operacji na tym źródle; nie może z nimi współbiec.
Przykład dla net10.0 najpierw odczytuje stan tokenu, następnie wywołuje Cancel() i odczytuje stan ponownie. Wyjście z bloku using wywołuje Dispose() przed ostatnim komunikatem. Brak zegarów i zadań działających w tle zapewnia deterministyczną kolejność wyjścia.
Przykłady
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.");Wynik
Before: False After: True Source disposed.
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.