Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

OperationCanceledException – sporočanje preklica operacije

OperationCanceledException sporoča, da je bila operacija preklicana. Spoznajte njeno sodelovanje s CancellationToken, delovanje metode ThrowIfCancellationRequested() in razliko med zahtevo za preklic ter odzivom nanjo.

Različica: .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 v imenskem prostoru System sporoča preklic operacije. Preklic je sodelovalen: CancellationTokenSource.Cancel() zahteva preklic, vendar sam ne prekine kode, ki se izvaja. Operacija mora zaznati zahtevo in končati svoje delo.

Priporočena kontrolna točka je token.ThrowIfCancellationRequested(): izjemo sproži samo, če je bil zahtevan preklic, in ji doda žeton. To je enakovredno preverjanju token.IsCancellationRequested in izvedbi throw new OperationCanceledException(token);. Lastnost CancellationToken izjeme omogoča prepoznavo povezanega žetona.

TaskCanceledException izhaja iz OperationCanceledException, zato prestrezanje osnovnega razreda zajame oba tipa. Pričakovani preklic obravnavajte na ustrezni meji operacije; filter v primeru preverja tako istovetnost žetona kot zahtevo za preklic, namesto da bi prezrl vsako izjemo te vrste.

Pri preobremenitvah Task.Run(..., token), ki sprejmejo sinhronega delegata, opravilo po sprožitvi te izjeme v zagnanem delegatu preide v stanje Canceled samo, če se žeton izjeme ujema s podanim žetonom in je bil za ta žeton zahtevan preklic. Sicer opravilo preide v stanje Faulted. Če se delegat normalno vrne, opravilo preide v stanje RanToCompletion.

Pri delegatu async, ki vrne opravilo, lahko izjema OperationCanceledException, ki je delegat ne prestreže, prekliče notranje opravilo, tudi če se žeton izjeme razlikuje od žetona, podanega metodi Task.Run, ali če preklic ni bil zahtevan. Posredniško opravilo, ki ga vrne Task.Run, odraža izid notranjega opravila. Sinhroni primer prikazuje mehanizem brez časovnih tekmovanj in ne zahteva jezikovnih funkcij različice preview.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri