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, , HttpWebRequestServicePointet sont obsolètes, et WebClient 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 sous-jacent WebRequest.
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 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 a pris fin. Pour savoir si l’opération s’est terminée correctement, vérifiez la Cancelled propriété sur la classe de base de 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.
