CKTIS / C#
CancellationTokenSource — pedir o cancelamento e libertar recursos
CancellationTokenSource gere o cancelamento cooperativo através de um CancellationToken. Cancel pede que o trabalho pare, enquanto Dispose liberta recursos e não cancela operações.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
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 disponibiliza, através de Token, um token que é passado às operações. Cancel() define IsCancellationRequested como true em todas as cópias desse token. O cancelamento é cooperativo: o código que recebe o token tem de reagir; o pedido não termina um thread à força. CancelAfter(...) permite agendar um pedido após um atraso especificado.
CancellationTokenSource.Dispose() liberta recursos, mas não pede o cancelamento nem substitui a espera pelo fim do trabalho. O proprietário da origem deve libertá-la quando terminar de a utilizar, por exemplo, através de using. Não utilize a origem depois disso. Chame Dispose() apenas depois de terminarem todas as outras operações sobre essa origem; não pode ser executado em simultâneo com elas.
O exemplo net10.0 lê o estado do token, chama Cancel() e volta a ler o estado. Ao sair do bloco using, Dispose() é chamado antes da mensagem final. Como não há temporizadores nem tarefas em segundo plano, a ordem da saída é determinística.
Exemplos
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.");Resultado
Before: False After: True Source disposed.
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.