WebClient.OnDownloadFileCompleted(AsyncCompletedEventArgs) 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.
Déclenche l’événement DownloadFileCompleted.
protected:
virtual void OnDownloadFileCompleted(System::ComponentModel::AsyncCompletedEventArgs ^ e);
protected virtual void OnDownloadFileCompleted (System.ComponentModel.AsyncCompletedEventArgs e);
abstract member OnDownloadFileCompleted : System.ComponentModel.AsyncCompletedEventArgs -> unit
override this.OnDownloadFileCompleted : System.ComponentModel.AsyncCompletedEventArgs -> unit
Protected Overridable Sub OnDownloadFileCompleted (e As AsyncCompletedEventArgs)
Paramètres
Objet AsyncCompletedEventArgs contenant des données d’événement.
Exemples
L’exemple de code suivant montre une implémentation de cette méthode qui peut être personnalisée par une classe dérivée de WebClient.
virtual void OnDownloadFileCompleted( System::ComponentModel::AsyncCompletedEventArgs ^ e ) override
{
// Here you can perform any custom actions before the event is raised
// and event handlers are called...
WebClient::OnDownloadFileCompleted( e );
// Here you can perform any post event actions...
}
protected override void OnDownloadFileCompleted (System.ComponentModel.AsyncCompletedEventArgs e)
{
// Here you can perform any custom actions before the event is raised
// and event handlers are called...
base.OnDownloadFileCompleted(e);
// Here you can perform any post event actions...
}
Remarques
Prudence
WebRequest
, HttpWebRequest
, ServicePoint
et WebClient
sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.
Les classes qui héritent de cette classe peuvent remplacer cette méthode pour effectuer des tâches supplémentaires lorsque l’événement DownloadFileCompleted se produit.
Le déclenchement d’un événement appelle le gestionnaire d’événements par le biais d’un délégué. Pour plus d’informations, consultez Gestion et déclenchement d’événements.
La méthode OnDownloadFileCompleted permet également aux classes dérivées de gérer l’événement sans attacher de délégué. Il s’agit de la technique recommandée pour gérer l’événement dans une classe dérivée.
Notes pour les héritiers
En cas de substitution de OnDownloadFileCompleted(AsyncCompletedEventArgs) dans une classe dérivée, veillez à appeler la méthode OnDownloadFileCompleted(AsyncCompletedEventArgs) de la classe de base afin que les délégués inscrits reçoivent l’événement.