WebClient.DownloadProgressChanged Ereignis

Definition

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Quelle:

WebClient.cs

Tritt ein, wenn Daten teilweise oder vollständig erfolgreich über einen asynchronen Download übertragen werden.

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

public event System.Net.DownloadProgressChangedEventHandler? DownloadProgressChanged;

member this.DownloadProgressChanged : System.Net.DownloadProgressChangedEventHandler 

Public Custom Event DownloadProgressChanged As DownloadProgressChangedEventHandler 

Ereignistyp

DownloadProgressChangedEventHandler

Beispiele

Im folgenden Codebeispiel wird das Festlegen eines Ereignishandlers für das DownloadProgressChanged Ereignis veranschaulicht.

// 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

Hinweise

Dieses Ereignis wird jedes Mal ausgelöst, wenn ein asynchroner Download voranschreitet. Dieses Ereignis wird ausgelöst, wenn Downloads mithilfe einer der folgenden Methoden gestartet werden.

Methode	BESCHREIBUNG
DownloadDataAsync	Lädt Daten aus einer Ressource herunter und gibt ein Byte Array zurück, ohne den aufrufenden Thread zu blockieren.
DownloadFileAsync	Lädt Daten aus einer Ressource in eine lokale Datei herunter, ohne den aufrufenden Thread zu blockieren.
OpenReadAsync	Gibt die Daten aus einer Ressource zurück, ohne den aufrufenden Thread zu blockieren.

Der DownloadProgressChangedEventHandler ist der Delegat für dieses Ereignis. Die DownloadProgressChangedEventArgs -Klasse stellt den Ereignishandler mit Ereignisdaten bereit.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Hinweis

Bei einer passiven FTP-Dateiübertragung wird immer ein Fortschrittsprozentsatz von 0 angezeigt, da der Server die Dateigröße nicht gesendet hat. Um den Fortschritt anzuzeigen, können Sie die FTP-Verbindung in aktiv ändern, indem Sie die GetWebRequest(Uri) virtuelle Methode überschreiben:

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