WebClient.DownloadProgressChanged Événement

Définition

Espace de noms:

System.Net

Assembly:

System.Net.WebClient.dll

Source:

WebClient.cs

Se produit lorsqu'une opération de téléchargement asynchrone transfère avec succès une partie ou l'ensemble des données.

public:
 event System::Net::DownloadProgressChangedEventHandler ^ DownloadProgressChanged;

public event System.Net.DownloadProgressChangedEventHandler? DownloadProgressChanged;

member this.DownloadProgressChanged : System.Net.DownloadProgressChangedEventHandler 

Public Custom Event DownloadProgressChanged As DownloadProgressChangedEventHandler 

Type d'événement

DownloadProgressChangedEventHandler

Exemples

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

// Sample call : DownLoadFileInBackground4 ("http://www.contoso.com/logs/January.txt");
void DownLoadFileInBackground4( String^ address )
{
   WebClient^ client = gcnew WebClient;
   Uri ^uri = gcnew Uri(address);

   // Specify a DownloadFileCompleted handler here...

   // Specify a progress notification handler.
   client->DownloadProgressChanged += gcnew DownloadProgressChangedEventHandler( DownloadProgressCallback4 );
   
   client->DownloadFileAsync( uri, "serverdata.txt" );
}

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

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

' Sample call : DownLoadFileInBackground4 ("http://www.contoso.com/logs/January.txt");
Public Shared Sub DownLoadFileInBackground4(ByVal address As String)

    Dim client As WebClient = New WebClient()

    ' Specify a DownloadFileCompleted handler here...

    '  Specify a progress notification handler.
    AddHandler client.DownloadProgressChanged, AddressOf DownloadProgressCallback4

    Dim uri as Uri = New Uri(address)
    client.DownloadFileAsync(uri, "serverdata.txt")

End Sub

Private Shared Sub DownloadProgressCallback4(ByVal sender As Object, ByVal e As DownloadProgressChangedEventArgs)
    ' Displays the operation identifier, and the transfer progress.
    Console.WriteLine("{0}    downloaded {1} of {2} bytes. {3} % complete...", _
    CStr(e.UserState), e.BytesReceived, e.TotalBytesToReceive, e.ProgressPercentage)
End Sub

Remarques

Cet événement est déclenché chaque fois qu’un téléchargement asynchrone progresse. Cet événement est déclenché lorsque les téléchargements sont démarrés à l’aide de l’une des méthodes suivantes.

Méthode	Description
DownloadDataAsync	Télécharge des données à partir d’une ressource et retourne un Byte tableau, sans bloquer le thread appelant.
DownloadFileAsync	Télécharge les données d’une ressource vers un fichier local, sans bloquer le thread appelant.
OpenReadAsync	Retourne les données d’une ressource, sans bloquer le thread appelant.

DownloadProgressChangedEventHandler est le délégué de cet événement. La DownloadProgressChangedEventArgs classe fournit au gestionnaire d’événements des données d’événement.

Pour plus d’informations sur la façon de gérer les événements, consultez gestion et déclenchement d’événements.

Notes

Un transfert de fichiers FTP passif affiche toujours un pourcentage de progression de zéro, car le serveur n’a pas envoyé la taille de fichier. Pour afficher la progression, vous pouvez modifier la connexion FTP sur active en remplaçant la GetWebRequest(Uri) méthode virtuelle :

internal class MyWebClient : WebClientProtocol
{
    protected override WebRequest GetWebRequest(Uri address)
    {
        FtpWebRequest req = (FtpWebRequest)base.GetWebRequest(address);
        req.UsePassive = false;
        return req;
    }
}