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.