WebClient.OnDownloadFileCompleted(AsyncCompletedEventArgs) メソッド

定義

DownloadFileCompleted イベントを発生させます。Raises the DownloadFileCompleted event.

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)

パラメーター

e
AsyncCompletedEventArgs

イベント データを格納している AsyncCompletedEventArgs オブジェクト。An AsyncCompletedEventArgs object containing event data.

次のコード例は、から派生したクラスによってカスタマイズできる、このメソッドの実装を示して WebClient います。The following code example shows an implementation of this method that can be customized by a class derived from 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...
}

注釈

このクラスを継承するクラスは、このメソッドをオーバーライドして、イベントが発生したときに追加のタスクを実行でき DownloadFileCompleted ます。Classes that inherit from this class can override this method to perform additional tasks when the DownloadFileCompleted event occurs.

イベントを発生させると、イベント ハンドラーがデリゲートから呼び出されます。Raising an event invokes the event handler through a delegate. 詳細については、処理とイベントの発生 を参照してください。For more information, see Handling and Raising Events.

OnDownloadFileCompleted メソッドを使用すると、デリゲートを結び付けずに、派生クラスでイベントを処理することもできます。The OnDownloadFileCompleted method also allows derived classes to handle the event without attaching a delegate. 派生クラスでイベントを処理する場合は、この手法をお勧めします。This is the preferred technique for handling the event in a derived class.

注意 (継承者)

派生クラスでをオーバーライドする場合は OnDownloadFileCompleted(AsyncCompletedEventArgs) 、登録されて OnDownloadFileCompleted(AsyncCompletedEventArgs) いるデリゲートがイベントを受け取るように、基本クラスのメソッドを呼び出す必要があります。When overriding OnDownloadFileCompleted(AsyncCompletedEventArgs) in a derived class, be sure to call the base class' OnDownloadFileCompleted(AsyncCompletedEventArgs) method so that registered delegates receive the event.

適用対象