ProgressChangedEventArgs.ProgressPercentage Propriedade

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.EventBasedAsync.dll

Origem:

ProgressChangedEvent.cs

Obtém o percentual de progresso da tarefa assíncrona.

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

public int ProgressPercentage { get; }

member this.ProgressPercentage : int

Public ReadOnly Property ProgressPercentage As Integer

Valor da propriedade

Int32

Um valor de percentual que indica o progresso da tarefa assíncrona.

Exemplos

O exemplo de código a seguir demonstra o uso desse membro. No exemplo, um manipulador de eventos relata a ocorrência do PictureBox.LoadProgressChanged evento. Este relatório ajuda você a aprender quando o evento ocorre e pode ajudá-lo na depuração. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir MessageBox.ShowConsole.WriteLine ou acrescentar a mensagem a uma multilinha TextBox.

Para executar o código de exemplo, cole-o em um projeto que contém uma instância do tipo PictureBox chamada PictureBox1. Em seguida, verifique se o manipulador de eventos está associado ao PictureBox.LoadProgressChanged evento.

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

Comentários

A ProgressPercentage propriedade determina qual porcentagem de uma tarefa assíncrona foi concluída.

Confira também

• BackgroundWorker
• Como implementar um componente que dá suporte ao padrão assíncrono baseado em evento
• Como: Executar uma operação em segundo plano
• Como: Implementar um formulário que usa uma operação em segundo plano
• Como usar componentes que dão suporte ao padrão assíncrono baseado em evento