CKTIS / C#
CancellationTokenSource — заявяване на отмяна и освобождаване на ресурси
CancellationTokenSource управлява кооперативната отмяна чрез CancellationToken. Cancel заявява спиране на работата, а Dispose освобождава ресурси и не отменя операции.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
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 предоставя чрез Token токен, който се предава на операциите. Cancel() задава IsCancellationRequested на true във всяко копие на този токен. Отмяната е кооперативна: кодът, който получава токена, трябва да реагира; самата заявка не прекратява принудително нишка. С CancelAfter(...) може да се планира заявка след определено забавяне.
CancellationTokenSource.Dispose() освобождава ресурси, но не заявява отмяна и не заменя изчакването работата да приключи. Собственикът на източника трябва да го освободи, когато приключи с използването му, например чрез using. След това не използвайте източника. Извикайте Dispose() едва след като приключат всички други операции върху този източник; той не трябва да се изпълнява едновременно с тях.
Примерът за net10.0 прочита състоянието на токена, извиква Cancel() и прочита състоянието отново. При излизане от блока using се извиква Dispose() преди последното съобщение. Тъй като няма таймери или фонови задачи, редът на изхода е детерминиран.
Примери
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.");Резултат
Before: False After: True Source disposed.
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.