IT CSharp Cancellation

Українська · Русский · English · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

Annulla, metti in pausa e script in background

Manuale C# · Esempi UO

CancellationTokenSource crea una richiesta di cancellazione, CancellationToken viene passato all'operazione. La cancellazione è cooperativa: l'operazione verifica il token o lo trasmette. Lo script incorporato ottiene Cancellation; WaitAsync viene utilizzato per l'attesa.

Esempio semplice (Example.csx)

Salvare questo esempio separatamente come Example.csx. Eseguirlo indipendentemente dagli altri esempi di questa pagina.

Example.csx:

Cancellation.ThrowIfCancellationRequested();
await WaitAsync(10);
UO.Print("Done");

L’annullamento è cooperativo: il controllo del token e WaitAsync rispondono a Stop; il codice esterno senza supporto all’annullamento può continuare.

Risultato:

Done

for (int i = 0; i < 3; i++)
{
    Cancellation.ThrowIfCancellationRequested();
    await WaitAsync(100);
    UO.Print($"Tick {i}");
}

{
    using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(1));
    using var linked = CancellationTokenSource.CreateLinkedTokenSource(Cancellation, timeout.Token);
    try
    {
        await Task.Delay(10, linked.Token);
        UO.Print("Operation completed");
    }
    catch (OperationCanceledException) when (timeout.IsCancellationRequested)
    {
        UO.Print("Local timeout");
    }
}

Non sostituire l'arresto dello script con un'intercettazione infinita OperationCanceledException. Una chiamata bloccante arbitraria a una libreria di terze parti non diventa interrompibile solo a causa della presenza di un token. La pausa e la richiesta di annullamento hanno scopi diversi: la pausa preserva la continuazione, l'annullamento termina l'esecuzione.

Documentazione ufficiale: Annulla, Pausa e Script in background - Microsoft Learn.

La richiesta di cancellazione è cooperativa. Task.Delay senza trasferimento Cancellation, in attesa di attività di terze parti e chiamata alla libreria senza supporto di annullamento può continuare dopo aver premuto Stop. Una volta effettuata la richiesta di cancellazione, sono vietate ulteriori attività di gioco di tale esecuzione; questo non forza la terminazione immediata di alcun codice .NET.