DownloadProgressChangedEventHandler Delegado

Definición

Espacio de nombres:

System.Net

Ensamblados:

netstandard.dll, System.Net.WebClient.dll

Representa el método que controlará el evento DownloadProgressChanged de WebClient.

C#

public delegate void DownloadProgressChangedEventHandler(object sender, DownloadProgressChangedEventArgs e);

Parámetros

sender

Object

Origen del evento.

e

DownloadProgressChangedEventArgs

DownloadProgressChangedEventArgs que contiene los datos del evento.

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer un controlador de eventos para el DownloadProgressChanged evento.

C#

// Sample call : DownLoadFileInBackground4 ("http://www.contoso.com/logs/January.txt");
public static void DownLoadFileInBackground4(string address)
{
    WebClient client = new WebClient();
    Uri uri = new Uri(address);

    // Specify a DownloadFileCompleted handler here...

    // Specify a progress notification handler.
    client.DownloadProgressChanged += new DownloadProgressChangedEventHandler(DownloadProgressCallback4);

    client.DownloadFileAsync(uri, "serverdata.txt");
}

private static void DownloadProgressCallback4(object sender, DownloadProgressChangedEventArgs e)
{
    // Displays the operation identifier, and the transfer progress.
    Console.WriteLine("{0}    downloaded {1} of {2} bytes. {3} % complete...",
        (string)e.UserState,
        e.BytesReceived,
        e.TotalBytesToReceive,
        e.ProgressPercentage);
}

Comentarios

Cuando se crea un delegado DownloadProgressChangedEventHandler, se identifica el método que controlará el evento. Para asociar el evento al controlador, se debe agregar una instancia del delegado al evento. Siempre que se produce el evento, se llama a su controlador, a menos que se quite el delegado. Para obtener más información sobre los delegados del controlador de eventos, vea Control y generación de eventos.

Nota

Si el servidor no envía el tamaño del archivo descargado (por ejemplo, en el caso de una conexión FTP pasiva), ProgressPercentage siempre puede ser cero.

Métodos de extensión

GetMethodInfo(Delegate)

Obtiene un objeto que representa el método representado por el delegado especificado.

Se aplica a