ProgressChangedEventArgs.UserState 屬性

定義

命名空間:

System.ComponentModel

組件:

System.ComponentModel.EventBasedAsync.dll

來源:

ProgressChangedEvent.cs

取得唯一的使用者狀態。

public:
 property System::Object ^ UserState { System::Object ^ get(); };

public object? UserState { get; }

member this.UserState : obj

Public ReadOnly Property UserState As Object

屬性值

Object

指出使用者狀態的唯一 Object。

範例

下列程式代碼範例示範如何使用這個成員。 在此範例中，事件處理程式會報告事件的發生次數 PictureBox.LoadProgressChanged 。 此報告可協助您瞭解事件發生的時間，並可協助您進行偵錯。 若要回報多個事件或經常發生的事件，請考慮將 取代 MessageBox.Show 為 Console.WriteLine 或將訊息附加至多行 TextBox。

若要執行範例程式代碼，請將它貼入包含名為 PictureBox1之類型PictureBox實例的專案。 然後，確定事件處理程式與 事件相關聯 PictureBox.LoadProgressChanged 。

private void PictureBox1_LoadProgressChanged(Object sender, ProgressChangedEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "ProgressPercentage", e.ProgressPercentage );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "UserState", e.UserState );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "LoadProgressChanged Event" );
}

Private Sub PictureBox1_LoadProgressChanged(sender as Object, e as ProgressChangedEventArgs) _ 
     Handles PictureBox1.LoadProgressChanged

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "ProgressPercentage", e.ProgressPercentage)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "UserState", e.UserState)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"LoadProgressChanged Event")

End Sub

另請參閱

• BackgroundWorker
• 如何：實作支援事件架構異步模式的元件
• 作法：在背景執行作業
• 作法：實作使用背景作業的表單
• 如何：使用支援事件架構異步模式的元件