WebClient.OnDownloadStringCompleted メソッド

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

WebClient.OnDownloadStringCompleted メソッド

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

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

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

Visual Basic (宣言)

Protected Overridable Sub
 OnDownloadStringCompleted ( _
    e As DownloadStringCompletedEventArgs _
)

Visual Basic (使用法)

Dim e As DownloadStringCompletedEventArgs

Me.OnDownloadStringCompleted(e)

C#

protected virtual void OnDownloadStringCompleted
 (
    DownloadStringCompletedEventArgs e
)

C++

protected:
virtual void OnDownloadStringCompleted (
    DownloadStringCompletedEventArgs^ e
)

J#

protected void OnDownloadStringCompleted (
    DownloadStringCompletedEventArgs e
)

JScript

protected function OnDownloadStringCompleted
 (
    e : DownloadStringCompletedEventArgs
)

パラメータ

e

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

解説

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

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

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

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

使用例

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

C#

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

    base.OnDownloadStringCompleted (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 名前空間