CKTIS / C#
OperationCanceledException – signaliziranje otkazivanja operacije
OperationCanceledException signalizira da je operacija otkazana. Saznajte kako surađuje s CancellationToken, što radi ThrowIfCancellationRequested() i koja je razlika između zahtjeva za otkazivanje i njegova prihvaćanja.
Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
token.ThrowIfCancellationRequested();
throw new OperationCanceledException(token);
catch (OperationCanceledException ex) when (ex.CancellationToken == token && token.IsCancellationRequested) { /* handle expected cancellation */ }OperationCanceledException u prostoru naziva System signalizira otkazivanje operacije. Otkazivanje je suradničko: CancellationTokenSource.Cancel() šalje zahtjev za otkazivanje, ali ne prekida sam po sebi kod koji se izvršava. Operacija mora uočiti zahtjev i zaustaviti svoj rad.
Preporučena kontrolna točka je token.ThrowIfCancellationRequested(): iznimku baca samo ako je zatraženo otkazivanje i uključuje token. To je ekvivalent provjeri token.IsCancellationRequested i izvođenju throw new OperationCanceledException(token);. Svojstvo CancellationToken iznimke omogućuje utvrđivanje tokena koji je s njom povezan.
TaskCanceledException nasljeđuje OperationCanceledException, pa hvatanje osnovne klase obuhvaća oba tipa. Očekivano otkazivanje obradite na odgovarajućoj granici operacije; filtar u primjeru provjerava i identitet tokena i zahtjev za otkazivanje, umjesto da zanemari svaku iznimku te vrste.
Kod preopterećenja metode Task.Run(..., token) koja prihvaćaju sinkroni delegat, ako se delegat izvrši i baci ovu iznimku, zadatak prelazi u stanje Canceled samo ako se token iznimke podudara s proslijeđenim tokenom i ako je za taj token zatraženo otkazivanje. U suprotnom zadatak prelazi u stanje Faulted. Ako delegat normalno završi, zadatak prelazi u stanje RanToCompletion.
Kod delegata async koji vraća zadatak, iznimka OperationCanceledException koja nije uhvaćena unutar delegata može otkazati unutarnji zadatak čak i ako se token iznimke razlikuje od tokena proslijeđenog metodi Task.Run ili otkazivanje nije zatraženo. Posrednički zadatak koji vrati Task.Run odražava ishod unutarnjeg zadatka. Sinkroni primjer prikazuje mehanizam bez vremenskih utrka i ne zahtijeva jezične značajke preview verzije.
Primjeri
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");
}
Rezultat
Canceled
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.