WebClient.OnDownloadFileCompleted(AsyncCompletedEventArgs) Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Źródło:

WebClient.cs

Zgłasza zdarzenie DownloadFileCompleted.

protected:
 virtual void OnDownloadFileCompleted(System::ComponentModel::AsyncCompletedEventArgs ^ e);

protected virtual void OnDownloadFileCompleted (System.ComponentModel.AsyncCompletedEventArgs e);

abstract member OnDownloadFileCompleted : System.ComponentModel.AsyncCompletedEventArgs -> unit
override this.OnDownloadFileCompleted : System.ComponentModel.AsyncCompletedEventArgs -> unit

Protected Overridable Sub OnDownloadFileCompleted (e As AsyncCompletedEventArgs)

Parametry

e

AsyncCompletedEventArgs

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

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

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

    base.OnDownloadFileCompleted(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 DownloadFileCompleted.

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