Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti