WebClient.CancelAsync Méthode

Définition

Espace de noms:

System.Net

Assembly:

System.Net.WebClient.dll

Source:

WebClient.cs

Annule une opération asynchrone en attente.

public:
 void CancelAsync();

public void CancelAsync ();

member this.CancelAsync : unit -> unit

Public Sub CancelAsync ()

Remarques

Si une opération est en attente, cette méthode appelle Abort sur le sous-jacent WebRequest.

Notes

À compter de .NET Core 2.0, CancelAsync n’annule pas immédiatement la demande si la réponse a commencé à être extraite. Pour un comportement d’annulation optimal, utilisez la HttpClient classe au lieu de WebClient.

Lorsque vous appelez CancelAsync, votre application reçoit toujours l’événement d’achèvement associé à l’opération. Par exemple, lorsque vous appelez CancelAsync pour annuler une DownloadStringAsync opération, si vous avez spécifié un gestionnaire d’événements pour l’événement DownloadStringCompleted , votre gestionnaire d’événements reçoit une notification indiquant que l’opération est terminée. Pour savoir si l’opération s’est terminée correctement, case activée la Cancelled propriété sur la classe de base de dans l’objet de DownloadDataCompletedEventArgs données d’événement passé au gestionnaire d’événements.

Si aucune opération asynchrone n’est en cours, cette méthode ne fait rien.