BackgroundWorker.ProgressChanged イベント

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

BackgroundWorker.ProgressChanged イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

ReportProgress が呼び出されたときに発生します。

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

Visual Basic (宣言)

Public Event ProgressChanged As
 ProgressChangedEventHandler

Visual Basic (使用法)

Dim instance As BackgroundWorker
Dim handler As ProgressChangedEventHandler

AddHandler instance.ProgressChanged, handler

C#

public event ProgressChangedEventHandler ProgressChanged

C++

public:
event ProgressChangedEventHandler^ ProgressChanged {
    void add (ProgressChangedEventHandler^ value);
    void remove (ProgressChangedEventHandler^ value);
}

J#

/** @event */
public void add_ProgressChanged (ProgressChangedEventHandler
 value)

/** @event */
public void remove_ProgressChanged (ProgressChangedEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

このイベントは、ReportProgress メソッドを呼び出したときに発生します。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

ProgressChanged イベントを使用して、非同期操作の進行状況をユーザーに報告するコード例を次に示します。このコード例は、BackgroundWorker クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' This event handler updates the progress bar.
Private Sub backgroundWorker1_ProgressChanged(
 _
ByVal sender As Object,
 ByVal e As ProgressChangedEventArgs) _
Handles backgroundWorker1.ProgressChanged

    Me.progressBar1.Value = e.ProgressPercentage

End Sub

C#

// This event handler updates the progress bar.
private void backgroundWorker1_ProgressChanged(object
 sender,
    ProgressChangedEventArgs e)
{
    this.progressBar1.Value = e.ProgressPercentage;
}

C++

// This event handler updates the progress bar.
void backgroundWorker1_ProgressChanged( Object^ /*sender*/, ProgressChangedEventArgs^
 e )
{
   this->progressBar1->Value = e->ProgressPercentage;
}

J#

// This event handler updates the progress bar.
private void backgroundWorker1_ProgressChanged(Object
 sender,
    ProgressChangedEventArgs e)
{
    this.progressBar1.set_Value(e.get_ProgressPercentage());
} //backgroundWorker1_ProgressChanged

プラットフォーム

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

参照

関連項目
BackgroundWorker クラス
BackgroundWorker メンバ
System.ComponentModel 名前空間
その他の技術情報
方法 : バックグラウンドで操作を実行する
方法 : バックグラウンドでファイルをダウンロードする