ProgressChangedEventArgs.UserState Eigenschaft

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.EventBasedAsync.dll

Quelle:

ProgressChangedEvent.cs

Ruft einen eindeutigen Benutzerzustand ab.

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

public object? UserState { get; }

member this.UserState : obj

Public ReadOnly Property UserState As Object

Eigenschaftswert

Object

Ein eindeutiges Object, das den Benutzerzustand angibt.

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Members veranschaulicht. Im Beispiel meldet ein Ereignishandler das Auftreten des Ereignisses PictureBox.LoadProgressChanged . Dieser Bericht hilft Ihnen, zu erfahren, wann das Ereignis eintritt, und kann Ihnen beim Debuggen helfen. Um über mehrere Ereignisse oder ereignisse zu berichten, die häufig auftreten, sollten Sie erwägen, die Nachricht durch Console.WriteLine ein mehrzeilesiges TextBoxzu ersetzen MessageBox.Show oder anzufügen.

Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine instance vom Typ PictureBox enthältPictureBox1. Stellen Sie dann sicher, dass der Ereignishandler dem PictureBox.LoadProgressChanged Ereignis zugeordnet ist.

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

Weitere Informationen

• BackgroundWorker
• Vorgehensweise: Implementieren einer Komponente, die das ereignisbasierte asynchrone Muster unterstützt
• How to: Ausführen eines Vorgangs im Hintergrund
• How to: Implementieren eines Formulars, das eine Hintergrundoperation verwendet
• Vorgehensweise: Verwenden von Komponenten, die das ereignisbasierte asynchrone Muster unterstützen