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

Признак отмены получается из источника признаков отмены, который представляет собой объект классаCancellationTokenSource,определенного в пространстве именSystem. Threading.Для того чтобы получить данный признак, нужно создать сначала экземпляр объекта типаCancellationTokenSource.(С этой целью можно воспользоваться вызываемым по умолчанию конструктором классаCancellationTokenSource.)Признак отмены, связанный сданным источником, оказывается доступным через используемое только для чтения свойствоToken,которое объявляется следующим образом.

public CancellationToken Token { get; }

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

Для отмены в задаче должна быть получена копия признака отмены и организован контроль этого признака с целью отслеживать саму отмену. Такое отслеживание можно организовать тремя способами: опросом, методом обратного вызова и с помощью дескриптора ожидания. Проще всего организовать опрос, и поэтому здесь будет рассмотрен именно этот способ. С целью опроса в задаче проверяется упомянутое выше свойствоIsCancellationRequestedпризнака отмены. Если это свойство содержит логическое значениеtrue,значит, отмена была запрошена, и задача должна быть завершена. Опрос может оказаться весьма эффективным, если организовать его правильно. Так, если задача содержит вложенные циклы, то проверка свойстваIsCancellationRequestedво внешнем цикле зачастую дает лучший результат, чем его проверка на каждом шаге внутреннего цикла.

Для создания задачи, из которой вызывается методThrowIfCancellationRequested ,когда она отменяется, обычно требуется передать признак отмены как самой задаче, так и конструктору классаTask,будь то непосредственно или же косвенно через методStartNew . Передача признака отмены самой задаче позволяет изменить состояние отменяемой задачи в запросе на отмену из внешнего кода. Далее будет использована следующая форма методаStartNew.

public Task StartNew(Actionсостояние,

CancellationTokenпризнак_отмены)

В этой форме признак отмены передается через параметры, обозначаемые каксостояниеипризнак_отмены.Это означает, что признак отмены будет передан как делегату, реализующему задачу, так и самому экземпляру объекта типаTask.Ниже приведена форма, поддерживающая делегатAction.

public delegate void Actioncin T>(Tobj)

В данном случае обобщенный параметрТобозначает типObject.В силу этого объектobjдолжен быть приведен внутри задачи к типуCancel lationToken.