public bool IsCancellationRequested { get; }
Оно возвращает логическое значение true
false
. И во-вторых, это метод ThrowIfCancellationRequested()
, который объявляется следующим образом.public void ThrowIfCancellationRequested()
Если признак отмены, для которого вызывается этот метод, получил запрос на отмену, то в данном методе генерируется исключение OperationCanceledException
AggregateException
, а затем его внутреннее исключение анализируется с помощью свойства InnerException
или InnerExceptions
. (Свойство InnerExceptions
представляет собой коллекцию исключений. Подробнее о коллекциях речь пойдет в главе 25.)Признак отмены получается из источника признаков отмены, который представляет собой объект класса CancellationTokenSource
System.Threading
. Для того чтобы получить данный признак, нужно создать сначала экземпляр объекта типа CancellationTokenSource
. (С этой целью можно воспользоваться вызываемым по умолчанию конструктором класса CancellationTokenSource
.) Признак отмены, связанный сданным источником, оказывается доступным через используемое только для чтения свойство Token, которое объявляется следующим образом.public CancellationToken Token { get; }
Это и есть тот признак, который должен быть передан отменяемой задаче.
Для отмены в задаче должна быть получена копия признака отмены и организован контроль этого признака с целью отслеживать саму отмену. Такое отслеживание можно организовать тремя способами: опросом, методом обратного вызова и с помощью дескриптора ожидания. Проще всего организовать опрос, и поэтому здесь будет рассмотрен именно этот способ. С целью опроса в задаче проверяется упомянутое выше свойство IsCancellationRequested
true
, значит, отмена была запрошена, и задача должна быть завершена. Опрос может оказаться весьма эффективным, если организовать его правильно. Так, если задача содержит вложенные циклы, то проверка свойства IsCancellationRequested
во внешнем цикле зачастую дает лучший результат, чем его проверка на каждом шаге внутреннего цикла.Для создания задачи, из которой вызывается метод ThrowIfCancellationRequested()
Task
, будь то непосредственно или же косвенно через метод StartNew()
. Передача признака отмены самой задаче позволяет изменить состояние отменяемой задачи в запросе на отмену из внешнего кода. Далее будет использована следующая форма метода StartNew()
.public Task StartNew(Action
CancellationToken
В этой форме признак отмены передается через параметры, обозначаемые как
Action
.public delegate void Actioncin T>(T obj)
В данном случае обобщенный параметр Т обозначает тип Object
CancellationToken
.И еще одно замечание: по завершении работы с источником признаков отмены следует освободить его ресурсы, вызвав метод Dispose()
Факт отмены задачи может быть проверен самыми разными способами. Здесь применяется следующий подход: проверка значения свойства IsCanceled
Task
. Если это логическое значение true
, то задача была отменена.