WebClient.OnDownloadFileCompleted(AsyncCompletedEventArgs) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Genera el evento 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)
Parámetros
Objeto AsyncCompletedEventArgs que contiene datos de eventos.
Ejemplos
En el ejemplo de código siguiente se muestra una implementación de este método que puede personalizar una clase derivada 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...
}
Comentarios
Cautela
WebRequest
, HttpWebRequest
, ServicePoint
y WebClient
están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.
Las clases que heredan de esta clase pueden invalidar este método para realizar tareas adicionales cuando se produce el evento DownloadFileCompleted.
La generación de un evento invoca el controlador de eventos a través de un delegado. Para obtener más información, vea control y generación de eventos.
El método OnDownloadFileCompleted también permite que las clases derivadas controle el evento sin adjuntar un delegado. Esta es la técnica preferida para controlar el evento en una clase derivada.
Notas a los desarrolladores de herederos
Al invalidar OnDownloadFileCompleted(AsyncCompletedEventArgs) en una clase derivada, asegúrese de llamar al método OnDownloadFileCompleted(AsyncCompletedEventArgs) de la clase base para que los delegados registrados reciban el evento.