WebClient.OnDownloadProgressChanged(DownloadProgressChangedEventArgs) Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Źródło:

WebClient.cs

Zgłasza zdarzenie DownloadProgressChanged.

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)

Parametry

e

DownloadProgressChangedEventArgs

Obiekt DownloadProgressChangedEventArgs zawierający dane zdarzenia.

Przykłady

Poniższy przykład kodu przedstawia implementację tej metody, którą można dostosować za pomocą klasy pochodzącej z WebClient.

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...
}

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Klasy dziedziczone z tej klasy mogą zastąpić tę metodę, aby wykonywać dodatkowe zadania po wystąpieniu zdarzenia DownloadProgressChanged.

Wywoływanie zdarzenia wywołuje procedurę obsługi zdarzeń za pośrednictwem delegata. Aby uzyskać więcej informacji, zobacz Obsługa i podnoszenie zdarzeń.

Metoda OnDownloadProgressChanged umożliwia również klasom pochodnym obsługę zdarzenia bez dołączania delegata. Jest to preferowana technika obsługi zdarzenia w klasie pochodnej.

Uwagi dotyczące dziedziczenia

Podczas zastępowania OnDownloadProgressChanged(DownloadProgressChangedEventArgs) w klasie pochodnej należy wywołać metodę OnDownloadProgressChanged(DownloadProgressChangedEventArgs) klasy bazowej, aby zarejestrowani delegaci odbierali zdarzenie.