Teilen über


WebClient.CancelAsync Methode

Definition

Bricht einen ausstehenden asynchronen Vorgang ab.

public:
 void CancelAsync();
public void CancelAsync ();
member this.CancelAsync : unit -> unit
Public 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.

Gilt für: