WebClient.OnDownloadFileCompleted メソッド

.NET Framework クラス ライブラリ リファレンス

WebClient.OnDownloadFileCompleted メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

DownloadFileCompleted イベントを発生させます。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Sub
 OnDownloadFileCompleted ( _
    e As AsyncCompletedEventArgs _
)

Visual Basic (使用法)

Dim e As AsyncCompletedEventArgs

Me.OnDownloadFileCompleted(e)

C#

protected virtual void OnDownloadFileCompleted
 (
    AsyncCompletedEventArgs e
)

C++

protected:
virtual void OnDownloadFileCompleted (
    AsyncCompletedEventArgs^ e
)

J#

protected void OnDownloadFileCompleted (
    AsyncCompletedEventArgs e
)

JScript

protected function OnDownloadFileCompleted
 (
    e : AsyncCompletedEventArgs
)

パラメータ

e

イベント データを格納している AsyncCompletedEventArgs オブジェクト。

解説

このクラスから継承するクラスは、このメソッドをオーバーライドして、DownloadFileCompleted イベントの発生時に追加のタスクを実行できます。

イベントが発生すると、デリゲートを使用してイベント ハンドラが呼び出されます。詳細については、「イベントの発生」を参照してください。

OnDownloadFileCompleted メソッドを使用すると、デリゲートを結び付けずに、派生クラスでイベントを処理することもできます。派生クラスでイベントを処理する場合は、この手法をお勧めします。

継承時の注意 派生クラスで OnDownloadFileCompleted をオーバーライドする場合は、登録されているデリゲートがイベントを受け取ることができるように、基本クラスの OnDownloadFileCompleted メソッドを必ず呼び出してください。

使用例

WebClient から派生したクラスでカスタマイズできるこのメソッドの実装を次のコード例に示します。

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WebClient クラス
WebClient メンバ
System.Net 名前空間