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

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

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; }

Это и есть тот признак, который должен быть передан отменяемой задаче.