WebClient.OnDownloadFileCompleted(AsyncCompletedEventArgs) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Löst das DownloadFileCompleted-Ereignis aus.
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)
Parameter
Ein AsyncCompletedEventArgs-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 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...
}
Hinweise
Vorsicht
WebRequest
, HttpWebRequest
, ServicePoint
und 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 DownloadFileCompleted-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 OnDownloadFileCompleted-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 OnDownloadFileCompleted(AsyncCompletedEventArgs) in einer abgeleiteten Klasse darauf, die OnDownloadFileCompleted(AsyncCompletedEventArgs) Methode der Basisklasse aufzurufen, damit registrierte Stellvertretungen das Ereignis empfangen.