BackgroundWorker.ProgressChanged 事件 (System.ComponentModel)

ProgressChanged 事件

开启低带宽视图

全部折叠

语言筛选器

此页面仅适用于

Microsoft Visual Studio 2008/.NET Framework 3.5

同时提供下列产品的其他版本：

.NET Framework 类库

BackgroundWorker..::.ProgressChanged 事件

更新：2007 年 11 月

调用 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

public event ProgressChangedEventHandler ProgressChanged

Visual C++

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

/** @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

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

Visual C++

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

// 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 Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。

版本信息