Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes