Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C#

CancellationTokenSource: solicitar la cancelación y liberar recursos

CancellationTokenSource gestiona la cancelación cooperativa mediante un CancellationToken. Cancel solicita que se detenga el trabajo, mientras que Dispose libera recursos y no cancela operaciones.

Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxis

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 proporciona, a través de Token, un token que se pasa a las operaciones. Cancel() establece IsCancellationRequested en true en todas las copias de ese token. La cancelación es cooperativa: el código que recibe el token debe responder; la solicitud no termina un hilo por la fuerza. CancelAfter(...) permite programar una solicitud después de un retraso determinado.

CancellationTokenSource.Dispose() libera recursos, pero no solicita la cancelación ni sustituye la espera a que el trabajo termine. El propietario de la fuente debe liberarla cuando haya terminado de usarla, por ejemplo, mediante using. No vuelvas a usar la fuente después. Llama a Dispose() solo cuando hayan terminado todas las demás operaciones sobre esa fuente; no debe ejecutarse a la vez que ellas.

El ejemplo net10.0 lee el estado del token, llama a Cancel() y vuelve a leer el estado. Al salir del bloque using, se llama a Dispose() antes del mensaje final. Al no haber temporizadores ni tareas en segundo plano, el orden de salida es determinista.

Ejemplos

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.

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes