ProgressChangedEventArgs.ProgressPercentage Właściwość

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

System.ComponentModel.EventBasedAsync.dll

Źródło:

ProgressChangedEvent.cs

Pobiera procent postępu asynchronicznego zadania.

public:
 property int ProgressPercentage { int get(); };

public int ProgressPercentage { get; }

member this.ProgressPercentage : int

Public ReadOnly Property ProgressPercentage As Integer

Wartość właściwości

Int32

Wartość procentowa wskazująca postęp asynchronicznego zadania.

Przykłady

Poniższy przykład kodu przedstawia użycie tego elementu członkowskiego. W tym przykładzie program obsługi zdarzeń zgłasza wystąpienie zdarzenia PictureBox.LoadProgressChanged . Ten raport pomaga dowiedzieć się, kiedy wystąpi zdarzenie i może pomóc w debugowaniu. Aby zgłosić wiele zdarzeń lub zdarzeń, które występują często, rozważ zastąpienie MessageBox.Show komunikatu ciągiem Console.WriteLine lub dołączeniem go do wielowierszowego TextBoxelementu .

Aby uruchomić przykładowy kod, wklej go w projekcie zawierającym wystąpienie typu PictureBox o nazwie PictureBox1. Następnie upewnij się, że program obsługi zdarzeń jest skojarzony ze zdarzeniem 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

Uwagi

Właściwość ProgressPercentage określa, jaki procent zadania asynchronicznego został ukończony.

Zobacz też

• BackgroundWorker
• Instrukcje: implementowanie składnika obsługującego wzorzec asynchroniczny oparty na zdarzeniach
• Instrukcje: uruchamianie operacji w tle
• Instrukcje: implementowanie formularza korzystającego z operacji w tle
• Instrukcje: używanie składników obsługujących wzorzec asynchroniczny oparty na zdarzeniach