WebClient.CancelAsync Methode

  • Referenz

Definition

Namespace:
System.Net
Assembly:
System.Net.WebClient.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Quelle:
WebClient.cs
Quelle:
WebClient.cs
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 diese Methode den zugrunde liegenden WebRequestaufAbort.

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 dem Vorgang zugeordnete Vervollständigungsereignis. Wenn Sie beispielsweise aufrufen CancelAsync , um einen DownloadStringAsync Vorgang abzubrechen, wenn Sie einen Ereignishandler für das DownloadStringCompleted Ereignis angegeben haben, erhält Ihr 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.

Gilt für: