WebClient.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.
Bricht einen ausstehenden asynchronen Vorgang ab.
public:
void CancelAsync();public void CancelAsync ();member this.CancelAsync : unit -> unitPublic Sub CancelAsync ()Hinweise
Vorsicht
WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.
Wenn ein Vorgang aussteht, ruft diese Methode Abort für die zugrunde liegende WebRequestauf.
Anmerkung
Ab .NET Core 2.0 wird CancelAsync die Anforderung nicht sofort abgebrochen, wenn die Antwort abgerufen wurde. Verwenden Sie für ein optimales Abbruchverhalten die HttpClient Klasse anstelle von WebClient.
Wenn Sie CancelAsyncaufrufen, empfängt Ihre Anwendung weiterhin das Abschlussereignis, das dem Vorgang zugeordnet ist. Wenn Sie z. B. CancelAsync aufrufen, um einen DownloadStringAsync Vorgang abzubrechen, wenn Sie einen Ereignishandler für das DownloadStringCompleted-Ereignis angegeben haben, empfängt der Ereignishandler eine Benachrichtigung, dass der Vorgang beendet wurde. Um zu erfahren, ob der Vorgang erfolgreich abgeschlossen wurde, überprüfen Sie die Cancelled-Eigenschaft auf der Basisklasse von DownloadDataCompletedEventArgs im Ereignisdatenobjekt, das an den Ereignishandler übergeben wird.
Wenn kein asynchroner Vorgang ausgeführt wird, führt diese Methode nichts aus.
