Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

OperationCanceledException – signalizácia zrušenia operácie

OperationCanceledException signalizuje, že operácia bola zrušená. Zistite, ako spolupracuje s CancellationToken, čo robí ThrowIfCancellationRequested() a aký je rozdiel medzi požiadavkou na zrušenie a reakciou na ňu.

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

Syntax

token.ThrowIfCancellationRequested();
throw new OperationCanceledException(token);
catch (OperationCanceledException ex) when (ex.CancellationToken == token && token.IsCancellationRequested) { /* handle expected cancellation */ }

OperationCanceledException v mennom priestore System signalizuje zrušenie operácie. Zrušenie je kooperatívne: CancellationTokenSource.Cancel() požiada o zrušenie, ale samo nepreruší práve vykonávaný kód. Operácia musí požiadavku zaznamenať a ukončiť svoju prácu.

Odporúčaným kontrolným bodom je token.ThrowIfCancellationRequested(): vyvolá výnimku iba vtedy, keď sa požiadalo o zrušenie, a pripojí token. Je to ekvivalent kontroly token.IsCancellationRequested a vykonania throw new OperationCanceledException(token);. Vlastnosť CancellationToken výnimky umožňuje určiť token, s ktorým je spojená.

TaskCanceledException dedí z OperationCanceledException, takže zachytenie základnej triedy pokrýva oba typy. Očakávané zrušenie spracujte na vhodnej hranici operácie; filter v príklade kontroluje identitu tokenu aj požiadavku na zrušenie, namiesto toho, aby ignoroval každú výnimku tohto typu.

Pri preťaženiach Task.Run(..., token), ktoré prijímajú synchrónneho delegáta, prejde úloha po vyvolaní tejto výnimky spusteným delegátom do stavu Canceled iba vtedy, ak sa token výnimky zhoduje s odovzdaným tokenom a prostredníctvom tohto tokenu sa požiadalo o zrušenie. Inak úloha prejde do stavu Faulted. Bežný návrat z delegáta vedie k stavu RanToCompletion.

Pri delegátovi async, ktorý vracia úlohu, môže výnimka OperationCanceledException nezachytená v delegátovi zrušiť vnútornú úlohu, aj keď sa token výnimky líši od tokenu odovzdaného metóde Task.Run alebo sa nepožiadalo o zrušenie. Zástupná úloha, ktorú vráti Task.Run, odráža spôsob ukončenia vnútornej úlohy. Synchrónny príklad ukazuje mechanizmus bez časových pretekov a nevyžaduje jazykové funkcie vo verzii preview.

Príklady

using System;
using System.Threading;

using var source = new CancellationTokenSource();
CancellationToken token = source.Token;
source.Cancel();

try
{
    token.ThrowIfCancellationRequested();
    Console.WriteLine("Completed");
}
catch (OperationCanceledException ex)
    when (ex.CancellationToken == token && token.IsCancellationRequested)
{
    Console.WriteLine("Canceled");
}

Výsledok

Canceled

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje