WebClient.CancelAsync WebClient.CancelAsync WebClient.CancelAsync WebClient.CancelAsync Method

Definition

Bricht einen ausstehenden asynchronen Vorgang ab.Cancels a pending asynchronous operation.

public:
 void CancelAsync();
public void CancelAsync ();
member this.CancelAsync : unit -> unit
Public Sub CancelAsync ()

Hinweise

Wenn ein Vorgang aussteht, ruft diese Methode Abort für die zugrunde liegende WebRequest auf.If an operation is pending, this method calls Abort on the underlying WebRequest.

Wenn Sie CancelAsync aufzurufen, empfängt Ihre Anwendung weiterhin das Abschluss Ereignis, das dem Vorgang zugeordnet ist.When you call CancelAsync, your application still receives the completion event associated with the operation. Wenn Sie z. b. CancelAsync aufzurufen, um einen DownloadStringAsync-Vorgang abzubrechen, wenn Sie einen Ereignishandler für das DownloadStringCompleted-Ereignis angegeben haben, erhält der Ereignishandler eine Benachrichtigung, dass der Vorgang beendet wurde.For example, when you call CancelAsync to cancel a DownloadStringAsync operation, if you have specified an event handler for the DownloadStringCompleted event, your event handler receives notification that the operation has ended. Um zu erfahren, ob der Vorgang erfolgreich abgeschlossen wurde, überprüfen Sie die Cancelled-Eigenschaft der Basisklasse von DownloadDataCompletedEventArgs im Ereignisdaten Objekt, das an den Ereignishandler weitergeleitet wird.To learn whether the operation completed successfully, check the Cancelled property on the base class of DownloadDataCompletedEventArgs in the event data object passed to the event handler.

Wenn kein asynchroner Vorgang ausgeführt wird, wird von dieser Methode nichts ausgeführt.If no asynchronous operation is in progress, this method does nothing.

Gilt für: