WebClient.CancelAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Annule une opération asynchrone en attente.
public:
void CancelAsync();public void CancelAsync ();member this.CancelAsync : unit -> unitPublic 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.
