WebClient.UploadProgressChanged Evento

Definición

Espacio de nombres:

System.Net

Ensamblados:

netstandard.dll, System.Net.WebClient.dll

Source:

WebClient.cs

Se produce cuando una operación de carga asincrónica transfiere correctamente algunos o todos los datos.

C#

public event System.Net.UploadProgressChangedEventHandler? UploadProgressChanged;

Tipo de evento

UploadProgressChangedEventHandler

Ejemplos

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

C#

// Sample call: UploadFileInBackground2("http://www.contoso.com/fileUpload.aspx", "data.txt")
public static void UploadFileInBackground2(string address, string fileName)
{
    WebClient client = new WebClient();
    Uri uri = new Uri(address);

    client.UploadFileCompleted += new UploadFileCompletedEventHandler(UploadFileCallback2);

    // Specify a progress notification handler.
    client.UploadProgressChanged += new UploadProgressChangedEventHandler(UploadProgressCallback);
    client.UploadFileAsync(uri, "POST", fileName);
    Console.WriteLine("File upload started.");
}

En el ejemplo de código siguiente se muestra una implementación de un controlador para este evento.

C#

private static void UploadProgressCallback(object sender, UploadProgressChangedEventArgs e)
{
    // Displays the operation identifier, and the transfer progress.
    Console.WriteLine("{0}    uploaded {1} of {2} bytes. {3} % complete...",
        (string)e.UserState,
        e.BytesSent,
        e.TotalBytesToSend,
        e.ProgressPercentage);
}
private static void DownloadProgressCallback(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

Advertencia

WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.

Este evento se genera cada vez que una carga asincrónica hace progreso. Este evento se genera cuando se inician las cargas mediante cualquiera de los métodos siguientes.

Método	Descripción
UploadDataAsync	Envía una matriz Byte al recurso, sin bloquear el subproceso que llama.
UploadFileAsync	Envía un archivo local al recurso, sin bloquear el subproceso que llama.
UploadValuesAsync	Envía un NameValueCollection al recurso y devuelve una matriz de Byte que contiene cualquier respuesta, sin bloquear el subproceso que realiza la llamada.

El UploadProgressChangedEventHandler es el delegado de este evento. La clase UploadProgressChangedEventArgs proporciona al controlador de eventos datos de eventos.

Para obtener más información sobre cómo controlar eventos, vea Control y generación de eventos.

Se aplica a