WebClient.OnUploadProgressChanged(UploadProgressChangedEventArgs) Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Źródło:

WebClient.cs

Zgłasza zdarzenie UploadProgressChanged.

protected:
 virtual void OnUploadProgressChanged(System::Net::UploadProgressChangedEventArgs ^ e);

protected virtual void OnUploadProgressChanged (System.Net.UploadProgressChangedEventArgs e);

abstract member OnUploadProgressChanged : System.Net.UploadProgressChangedEventArgs -> unit
override this.OnUploadProgressChanged : System.Net.UploadProgressChangedEventArgs -> unit

Protected Overridable Sub OnUploadProgressChanged (e As UploadProgressChangedEventArgs)

Parametry

e

UploadProgressChangedEventArgs

Obiekt UploadProgressChangedEventArgs 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 OnUploadProgressChanged( UploadProgressChangedEventArgs ^ e ) override
{
   // Here you can perform any custom actions before the event is raised
   // and event handlers are called...
   WebClient::OnUploadProgressChanged( e );

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

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

    base.OnUploadProgressChanged (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 UploadProgressChanged.

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 OnUploadProgressChanged 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 OnUploadProgressChanged(UploadProgressChangedEventArgs) w klasie pochodnej należy wywołać metodę OnUploadProgressChanged(UploadProgressChangedEventArgs) klasy bazowej, aby zarejestrowani delegaci odbierali zdarzenie.