CKTIS / C#
CancellationTokenSource — richiedere l’annullamento e rilasciare le risorse
CancellationTokenSource gestisce l’annullamento cooperativo tramite un CancellationToken. Cancel richiede di interrompere il lavoro, mentre Dispose rilascia le risorse e non annulla le operazioni.
Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintassi
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 rende disponibile tramite Token un token da passare alle operazioni. Cancel() imposta IsCancellationRequested su true in ogni copia di quel token. L’annullamento è cooperativo: il codice che riceve il token deve reagire; la richiesta non termina forzatamente un thread. CancelAfter(...) consente di programmare una richiesta dopo un ritardo specificato.
CancellationTokenSource.Dispose() rilascia le risorse, ma non richiede l’annullamento e non sostituisce l’attesa del completamento del lavoro. Il proprietario della sorgente dovrebbe rilasciarla quando ha finito di usarla, per esempio tramite using. Non usare la sorgente in seguito. Chiama Dispose() solo dopo che tutte le altre operazioni su quella sorgente sono terminate; non deve essere eseguito contemporaneamente a esse.
L’esempio net10.0 legge lo stato del token, chiama Cancel() e legge di nuovo lo stato. Uscendo dal blocco using, Dispose() viene chiamato prima del messaggio finale. L’assenza di timer e attività in background rende deterministico l’ordine dell’output.
Esempi
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.");Risultato
Before: False After: True Source disposed.
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.