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

Prudence

WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

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

Note

À compter de .NET Core 2.0, CancelAsync n’annule pas la requête immédiatement si la réponse a commencé à extraire. Pour un comportement d’annulation optimal, utilisez la classe HttpClient 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 opération de DownloadStringAsync, 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 a pris fin. Pour savoir si l’opération s’est terminée correctement, vérifiez la propriété Cancelled sur la classe de base de DownloadDataCompletedEventArgs dans l’objet de 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.