WebClient.CancelAsync Methode

Definition

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Quelle:

WebClient.cs

Bricht einen ausstehenden asynchronen Vorgang ab.

public:
 void CancelAsync();

public void CancelAsync ();

member this.CancelAsync : unit -> unit

Public Sub CancelAsync ()

Hinweise

Wenn ein Vorgang aussteht, ruft Abort diese Methode für den zugrunde liegenden WebRequestauf.

Hinweis

Ab .NET Core 2.0 wird die Anforderung nicht sofort abgebrochen, CancelAsync wenn die Antwort mit dem Abrufen begonnen hat. Verwenden Sie für ein optimales Abbruchverhalten die HttpClient -Klasse anstelle von WebClient.

Wenn Sie aufrufen CancelAsync, empfängt Ihre Anwendung weiterhin das Abschlussereignis, das dem Vorgang zugeordnet ist. Wenn Sie z. B. aufrufen CancelAsync , um einen DownloadStringAsync Vorgang abzubrechen, und wenn Sie einen Ereignishandler für das DownloadStringCompleted Ereignis angegeben haben, erhält Der Ereignishandler eine Benachrichtigung, dass der Vorgang beendet wurde. Um zu erfahren, ob der Vorgang erfolgreich abgeschlossen wurde, überprüfen Sie die Cancelled -Eigenschaft für die Basisklasse von DownloadDataCompletedEventArgs im Ereignisdatenobjekt, das an den Ereignishandler übergeben wurde.

Wenn kein asynchroner Vorgang ausgeführt wird, führt diese Methode nichts aus.