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 -> 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:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für