DownloadProgressChangedEventHandler Délégué

Définition

Espace de noms:

System.Net

Assemblys:

netstandard.dll, System.Net.WebClient.dll

Représente la méthode qui gérera l'événement DownloadProgressChanged d'un WebClient.

C#

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

Paramètres

sender

Object

Source de l'événement.

e

DownloadProgressChangedEventArgs

DownloadProgressChangedEventArgs contenant les données d’événement.

Exemples

L’exemple de code suivant illustre la définition d’un gestionnaire d’événements pour l’événement DownloadProgressChanged .

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);
}

Remarques

Lorsque vous créez un délégué DownloadProgressChangedEventHandler, vous identifiez la méthode qui gérera l'événement. Pour associer l'événement au gestionnaire d'événements, ajoutez une instance du délégué à l'événement. Le gestionnaire d'événements est appelé chaque fois qu'un événement se produit, sauf si vous supprimez le délégué. Pour plus d’informations sur les délégués de gestionnaires d’événements, consultez Gestion et déclenchement d’événements.

Note

Si le serveur n’envoie pas la taille du fichier téléchargé (par exemple, dans le cas d’une connexion FTP passive), ProgressPercentage peut toujours être égale à zéro.

Méthodes d’extension

GetMethodInfo(Delegate)

Obtient un objet qui représente la méthode représentée par le délégué spécifié.

S’applique à