DoWorkEventHandler Delegado

Definición

Espacio de nombres:

System.ComponentModel

Ensamblado:

System.ComponentModel.EventBasedAsync.dll

Representa el método que controlará el evento DoWork. Esta clase no puede heredarse.

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

Origen del evento.

e

DoWorkEventArgs

Objeto DoWorkEventArgs que contiene los datos del evento.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el DoWorkEventHandler delegado para controlar el DoWork evento. Para obtener una lista de código completa, vea Cómo: Ejecutar una operación en 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

Comentarios

Cuando se crea un delegado DoWorkEventHandler, se identifica el método que controlará el evento. Para asociar el evento al controlador, se debe agregar una instancia del delegado al evento. Se llama al método de controlador de eventos cada vez que se produce el evento, a menos que quite el delegado. Para obtener más información sobre los delegados del controlador de eventos, vea Control y generación de eventos.

Métodos de extensión

GetMethodInfo(Delegate)

Obtiene un objeto que representa el método representado por el delegado especificado.

Consulte también

• BackgroundWorker
• Cómo: Ejecutar una operación en segundo plano