CancellationTokenSource.CancelAsync Methode

Definition

Namespace:

System.Threading

Assembly:

System.Runtime.dll

Quelle:

CancellationTokenSource.cs

Kommuniziert eine Anforderung für den Abbruch asynchron.

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

Gibt zurück

Task

Eine Aufgabe, die abgeschlossen wird, nachdem abgebrochene Vorgänge und Rückrufe, die bei dem zugeordneten CancellationToken registriert wurden, abgeschlossen sind.

Ausnahmen

ObjectDisposedException

Diese CancellationTokenSource wurde verworfen.

Hinweise

Die zugeordnete CancellationToken wird über den Abbruch benachrichtigt und wechselt synchron in einen Zustand, in dem IsCancellationRequested zurückgibt true. Alle Rückrufe oder abbruchbaren Vorgänge, die bei registriert CancellationToken sind, werden asynchron ausgeführt, wobei der zurückgegebene Task die endgültige Vervollständigung darstellt.

Rückrufe, die mit dem Token registriert sind, sollten keine Ausnahmen auslösen. Alle ausgelösten Ausnahmen werden jedoch zu einem AggregateExceptionaggregiert, sodass ein Rückruf, der eine Ausnahme auslöst, nicht verhindert, dass andere registrierte Rückrufe ausgeführt werden.

Die ExecutionContext , die erfasst wurde, als jeder Rückruf registriert wurde, wird beim Aufrufen des Rückrufs wiederhergestellt.