DoWorkEventHandler Delegar

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.EventBasedAsync.dll

Representa o método que manipulará o evento de DoWork . Essa classe não pode ser herdada.

public delegate void DoWorkEventHandler(System::Object ^ sender, DoWorkEventArgs ^ e);

public delegate void DoWorkEventHandler(object? sender, DoWorkEventArgs e);

type DoWorkEventHandler = delegate of obj * DoWorkEventArgs -> unit

Public Delegate Sub DoWorkEventHandler(sender As Object, e As DoWorkEventArgs)

Parâmetros

sender

Object

A fonte do evento.

e

DoWorkEventArgs

Um DoWorkEventArgs que contém os dados do evento.

Exemplos

O exemplo de código a seguir demonstra como usar o DoWorkEventHandler delegado para manipular o DoWork evento. Para obter uma listagem de código completa, consulte Como executar uma operação em segundo plano.

private void backgroundWorker1_DoWork(object sender, DoWorkEventArgs e)
{
    // Do not access the form's BackgroundWorker reference directly.
    // Instead, use the reference provided by the sender parameter.
    BackgroundWorker bw = sender as BackgroundWorker;

    // Extract the argument.
    int arg = (int)e.Argument;

    // Start the time-consuming operation.
    e.Result = TimeConsumingOperation(bw, arg);

    // If the operation was canceled by the user, 
    // set the DoWorkEventArgs.Cancel property to true.
    if (bw.CancellationPending)
    {
        e.Cancel = true;
    }
}

Private Sub backgroundWorker1_DoWork( _
sender As Object, e As DoWorkEventArgs) _
Handles backgroundWorker1.DoWork

   ' Do not access the form's BackgroundWorker reference directly.
   ' Instead, use the reference provided by the sender parameter.
   Dim bw As BackgroundWorker = CType( sender, BackgroundWorker )
   
   ' Extract the argument.
   Dim arg As Integer = Fix(e.Argument)
   
   ' Start the time-consuming operation.
   e.Result = TimeConsumingOperation(bw, arg)
   
   ' If the operation was canceled by the user, 
   ' set the DoWorkEventArgs.Cancel property to true.
   If bw.CancellationPending Then
      e.Cancel = True
   End If

End Sub

Comentários

Ao criar um DoWorkEventHandler delegado, você identifica o método que manipulará o evento. Para associar o evento ao manipulador de eventos, adicione uma instância do delegado ao evento. O método de manipulador de eventos é chamado sempre que o evento ocorre, a menos que você remova o delegado. Para obter mais informações sobre delegados do manipulador de eventos, consulte Manipulando e levantando eventos.

Métodos de Extensão

GetMethodInfo(Delegate)

Obtém um objeto que representa o método representado pelo delegado especificado.

Confira também

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