CancellationTokenSource.CancelAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
Eine Aufgabe, die abgeschlossen wird, nachdem abgebrochene Vorgänge und Rückrufe, die bei dem zugeordneten CancellationToken registriert wurden, abgeschlossen sind.
Ausnahmen
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.