CancellationTokenSource.CancelAsync Metodo

Definizione

Spazio dei nomi:

System.Threading

Assembly:

System.Runtime.dll

Origine:

CancellationTokenSource.cs

Comunica una richiesta di annullamento in modo asincrono.

public:
 System::Threading::Tasks::Task ^ CancelAsync();

public System.Threading.Tasks.Task CancelAsync ();

member this.CancelAsync : unit -> System.Threading.Tasks.Task

Public Function CancelAsync () As Task

Restituisce

Task

Attività che verrà completata dopo il completamento delle operazioni annullabili e dei callback registrati con l'oggetto associato CancellationToken .

Eccezioni

ObjectDisposedException

Questo oggetto CancellationTokenSource è stato eliminato.

Commenti

L'oggetto associato CancellationToken riceverà una notifica dell'annullamento e passerà in modo sincrono a uno stato in cui IsCancellationRequested restituisce true. Qualsiasi callback o operazione annullabile registrata con CancellationToken verrà eseguita in modo asincrono, con l'oggetto restituito Task che rappresenta il completamento finale.

I callback registrati con il token non devono generare eccezioni. Tuttavia, eventuali eccezioni generate verranno aggregate in un oggetto AggregateException, in modo che un callback che genera un'eccezione non impedisca l'esecuzione di altri callback registrati.

L'oggetto ExecutionContext acquisito quando ogni callback è stato registrato verrà ristabilito quando viene richiamato il callback.