RunWorkerCompletedEventArgs Classe

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.EventBasedAsync.dll

Origem:

RunWorkerCompletedEvent.cs

Fornece dados para o evento MethodNameCompleted .

public ref class RunWorkerCompletedEventArgs : System::ComponentModel::AsyncCompletedEventArgs

public class RunWorkerCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs

type RunWorkerCompletedEventArgs = class
    inherit AsyncCompletedEventArgs

Public Class RunWorkerCompletedEventArgs
Inherits AsyncCompletedEventArgs

Herança

Object

EventArgs

AsyncCompletedEventArgs

RunWorkerCompletedEventArgs

Exemplos

O exemplo de código a seguir ilustra o uso do objeto RunWorkerCompletedEventArgs. Este exemplo faz parte de um exemplo maior para a BackgroundWorker classe .

// This event handler deals with the results of the
// background operation.
void backgroundWorker1_RunWorkerCompleted( Object^ /*sender*/, RunWorkerCompletedEventArgs^ e )
{
   // First, handle the case where an exception was thrown.
   if ( e->Error != nullptr )
   {
      MessageBox::Show( e->Error->Message );
   }
   else
   if ( e->Cancelled )
   {
      // Next, handle the case where the user cancelled 
      // the operation.
      // Note that due to a race condition in 
      // the DoWork event handler, the Cancelled
      // flag may not have been set, even though
      // CancelAsync was called.
      resultLabel->Text = "Cancelled";
   }
   else
   {
      // Finally, handle the case where the operation 
      // succeeded.
      resultLabel->Text = e->Result->ToString();
   }

   // Enable the UpDown control.
   this->numericUpDown1->Enabled = true;

   // Enable the Start button.
   startAsyncButton->Enabled = true;

   // Disable the Cancel button.
   cancelAsyncButton->Enabled = false;
}

// This event handler deals with the results of the
// background operation.
private void backgroundWorker1_RunWorkerCompleted(
    object sender, RunWorkerCompletedEventArgs e)
{
    // First, handle the case where an exception was thrown.
    if (e.Error != null)
    {
        MessageBox.Show(e.Error.Message);
    }
    else if (e.Cancelled)
    {
        // Next, handle the case where the user canceled 
        // the operation.
        // Note that due to a race condition in 
        // the DoWork event handler, the Cancelled
        // flag may not have been set, even though
        // CancelAsync was called.
        resultLabel.Text = "Canceled";
    }
    else
    {
        // Finally, handle the case where the operation 
        // succeeded.
        resultLabel.Text = e.Result.ToString();
    }

    // Enable the UpDown control.
    this.numericUpDown1.Enabled = true;

    // Enable the Start button.
    startAsyncButton.Enabled = true;

    // Disable the Cancel button.
    cancelAsyncButton.Enabled = false;
}

' This event handler deals with the results of the
' background operation.
Private Sub backgroundWorker1_RunWorkerCompleted( _
ByVal sender As Object, ByVal e As RunWorkerCompletedEventArgs) _
Handles backgroundWorker1.RunWorkerCompleted

    ' First, handle the case where an exception was thrown.
    If (e.Error IsNot Nothing) Then
        MessageBox.Show(e.Error.Message)
    ElseIf e.Cancelled Then
        ' Next, handle the case where the user canceled the 
        ' operation.
        ' Note that due to a race condition in 
        ' the DoWork event handler, the Cancelled
        ' flag may not have been set, even though
        ' CancelAsync was called.
        resultLabel.Text = "Canceled"
    Else
        ' Finally, handle the case where the operation succeeded.
        resultLabel.Text = e.Result.ToString()
    End If

    ' Enable the UpDown control.
    Me.numericUpDown1.Enabled = True

    ' Enable the Start button.
    startAsyncButton.Enabled = True

    ' Disable the Cancel button.
    cancelAsyncButton.Enabled = False
End Sub

Comentários

Ao usar o padrão assíncrono baseado em evento para operações assíncronas, um formulário ou controle de Windows Forms inicia uma operação assíncrona chamando o BackgroundWorker.RunWorkerAsync método . O método, por sua vez, gera o BackgroundWorker.DoWork evento de forma assíncrona e passa uma DoWorkEventArgs instância para ele. Se a operação assíncrona retornar um valor, o BackgroundWorker.DoWork manipulador de eventos normalmente o DoWorkEventArgs.Result atribuirá à propriedade . Quando a operação assíncrona é concluída, o BackgroundWorker.RunWorkerCompleted evento é acionado e é passado uma RunWorkerCompletedEventArgs instância que contém informações sobre a status da operação (se ela foi cancelada, com falha ou concluída com êxito). Se tiver sido concluída com êxito, sua Result propriedade conterá o valor retornado pela operação assíncrona e atribuído anteriormente à DoWorkEventArgs.Result propriedade .

Observação

O HostProtectionAttribute atributo aplicado a essa classe tem o seguinte Resources valor de propriedade: SharedState. HostProtectionAttribute não afeta aplicativos de área de trabalho (que são normalmente iniciados com o clique duplo em um ícone, a digitação de um comando ou a inserção de uma URL em um navegador). Para obter mais informações, consulte a HostProtectionAttribute classe ou SQL Server Atributos de Programação e Proteção de Host.

Construtores

RunWorkerCompletedEventArgs(Object, Exception, Boolean)

Inicializa uma nova instância da classe RunWorkerCompletedEventArgs.

Propriedades

Cancelled	Obtém um valor que indica se uma operação assíncrona foi cancelada. (Herdado de AsyncCompletedEventArgs)
Error	Obtém um valor que indica qual erro ocorreu durante uma operação assíncrona. (Herdado de AsyncCompletedEventArgs)
Result	Obtém um valor que representa o resultado de uma operação assíncrona.
UserState	Obtém um valor que representa o estado do usuário.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
RaiseExceptionIfNecessary()	Gera uma exceção fornecida pelo usuário se uma operação assíncrona falhou. (Herdado de AsyncCompletedEventArgs)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• BackgroundWorker
• Como: Executar uma operação em segundo plano
• Como: Como baixar um arquivo em segundo plano