WebClient.OnDownloadProgressChanged(DownloadProgressChangedEventArgs) Methode

Definition

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Quelle:

WebClient.cs

Löst das DownloadProgressChanged-Ereignis aus.

protected:
 virtual void OnDownloadProgressChanged(System::Net::DownloadProgressChangedEventArgs ^ e);

protected virtual void OnDownloadProgressChanged (System.Net.DownloadProgressChangedEventArgs e);

abstract member OnDownloadProgressChanged : System.Net.DownloadProgressChangedEventArgs -> unit
override this.OnDownloadProgressChanged : System.Net.DownloadProgressChangedEventArgs -> unit

Protected Overridable Sub OnDownloadProgressChanged (e As DownloadProgressChangedEventArgs)

Parameter

e

DownloadProgressChangedEventArgs

Ein DownloadProgressChangedEventArgs-Objekt, das Ereignisdaten enthält.

Beispiele

Das folgende Codebeispiel zeigt eine Implementierung dieser Methode, die von einer von WebClientabgeleiteten Klasse angepasst werden kann.

virtual void OnDownloadProgressChanged( DownloadProgressChangedEventArgs ^ e ) override
{
   // Here you can perform any custom actions before the event is raised
   // and event handlers are called...
   WebClient::OnDownloadProgressChanged( e );

   // Here you can perform any post event actions...
}

protected override void OnDownloadProgressChanged (DownloadProgressChangedEventArgs e)
{
    // Here you can perform any custom actions before the event is raised
    // and event handlers are called...

    base.OnDownloadProgressChanged (e);

    // Here you can perform any post event actions...
}

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Klassen, die von dieser Klasse erben, können diese Methode überschreiben, um zusätzliche Aufgaben auszuführen, wenn das DownloadProgressChanged-Ereignis auftritt.

Das Auslösen eines Ereignisses ruft den Ereignishandler über einen Delegaten auf. Weitere Informationen finden Sie unter Behandeln und Auslösen von Ereignissen.

Mit der OnDownloadProgressChanged-Methode können abgeleitete Klassen auch das Ereignis behandeln, ohne einen Delegaten anzufügen. Dies ist die bevorzugte Technik für die Behandlung des Ereignisses in einer abgeleiteten Klasse.

Hinweise für Vererber

Achten Sie beim Überschreiben von OnDownloadProgressChanged(DownloadProgressChangedEventArgs) in einer abgeleiteten Klasse darauf, die OnDownloadProgressChanged(DownloadProgressChangedEventArgs) Methode der Basisklasse aufzurufen, damit registrierte Stellvertretungen das Ereignis empfangen.