CKTIS / C#
OperationCanceledException — сигнализиране за отмяна на операция
OperationCanceledException сигнализира, че дадена операция е отменена. Научете как работи с CancellationToken, какво прави ThrowIfCancellationRequested() и каква е разликата между заявяването на отмяна и реакцията на заявката.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
token.ThrowIfCancellationRequested();
throw new OperationCanceledException(token);
catch (OperationCanceledException ex) when (ex.CancellationToken == token && token.IsCancellationRequested) { /* handle expected cancellation */ }OperationCanceledException в пространството от имена System сигнализира за отмяна на операция. Отмяната е кооперативна: CancellationTokenSource.Cancel() заявява отмяна, но сам по себе си не прекъсва изпълнявания код. Операцията трябва да забележи заявката и да спре работата си.
Препоръчителната контролна точка е token.ThrowIfCancellationRequested(): тя хвърля изключение само ако е заявена отмяна и включва токена. Това е равностойно на проверка на token.IsCancellationRequested и изпълнение на throw new OperationCanceledException(token);. Свойството CancellationToken на изключението показва с кой токен е свързано.
TaskCanceledException наследява OperationCanceledException, затова прихващането на базовия клас обхваща и двата типа. Обработвайте очакваната отмяна на подходяща граница на операцията; филтърът в примера проверява както идентичността на токена, така и заявката за отмяна, вместо да пренебрегва всяко изключение от този тип.
При претоварените варианти на Task.Run(..., token), които приемат синхронен делегат, ако делегатът се изпълни и хвърли това изключение, задачата преминава в състояние Canceled само ако токенът на изключението съвпада с подадения токен и за този токен е заявена отмяна. В противен случай задачата преминава в състояние Faulted. Ако делегатът приключи нормално, състоянието е RanToCompletion.
При делегат async, който връща задача, неприхванато в делегата изключение OperationCanceledException може да отмени вътрешната задача дори ако токенът на изключението се различава от подадения на Task.Run токен или не е заявена отмяна. Посредническата задача, върната от Task.Run, отразява начина, по който приключва вътрешната задача. Синхронният пример показва механизма без времеви състезания и не изисква езикови функции от preview версията.
Примери
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");
}
Резултат
Canceled
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.