База знанияИзпитен център
BGБългарски
Избери език13

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.

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници