C# 4.0 полное руководство - 2011

Отмена задачи, как правило, выполняется следующим образом. Сначала получается признак отмены из источника признаков отмены. Затем этот признак передается задаче, после чего она должна контролировать его на предмет получения запроса на отмену. (Этот запрос может поступить только из источника признаков отмены.) Если получен запрос на отмену, задача должна завершиться. В одних случаях этого оказывается достаточно для простого прекращения задачи без каких-либо дополнительных действий, а в других — из задачи должен быть вызван методThrowIfCancellationRequested для признака отмены. Благодаря этому в отменяющем коде становится известно, что задача отменена. А теперь рассмотрим процесс отмены задачи более подробно.

'Признак отмены является экземпляром объекта типаCancellationToken,т.е. структуры, определенной в пространстве именSystem. Threading.В структуреCancellationTokenопределено несколько свойств и методов, но мы воспользуемся двумя из них. Во-первых, это доступное только для чтения свойствоIsCancellation Re quested,которое объявляется следующим образом.

public bool IsCancellationRequested { get; }

Оно возвращает логическое значениеtrue,если отмена задачи была запрошена для вызывающего признака, а иначе — логическое значениеfalse.И во-вторых, это методThrowIfCancellationRequested , который объявляется следующим образом.

public void ThrowIfCancellationRequested

Если признак отмены, для которого вызывается этот метод, получил запрос на отмену, то в данном методе генерируется исключениеOperationCanceledException.В противномслучаеникаких действий не выполняется. В отменяющем коде можно организовать отслеживание упомянутого исключения с целью убедиться в том, что отмена задачи действительно произошла. Как правило, с этой целью сначала перехватывается исключениеAggregateException,а затем его внутреннее исключение анализируется с помощью свойстваInnerExceptionилиInnerExceptions.(СвойствоInnerExceptionsпредставляет собой коллекцию исключений. Подробнее о коллекциях речь пойдет в главе 25.)