DoWorkEventHandler Délégué

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.ComponentModel.EventBasedAsync.dll

Représente la méthode qui gérera l'événement DoWork. Cette classe ne peut pas être héritée.

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)

Paramètres

sender

Object

Source de l'événement.

e

DoWorkEventArgs

DoWorkEventArgs qui contient les données d’événement.

Exemples

L’exemple de code suivant montre comment utiliser le DoWorkEventHandler délégué pour gérer l’événement DoWork . Pour obtenir une liste de code complète, consultez Guide pratique pour exécuter une opération en arrière-plan.

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

Remarques

Lorsque vous créez un délégué DoWorkEventHandler, vous identifiez la méthode qui gérera l'événement. Pour associer l'événement au gestionnaire d'événements, ajoutez une instance du délégué à l'événement. La méthode de gestionnaire d’événements est appelée chaque fois que l’événement se produit, sauf si vous supprimez le délégué. Pour plus d’informations sur les délégués de gestionnaire d’événements, consultez Gestion et déclenchement d’événements.

Méthodes d’extension

GetMethodInfo(Delegate)

Obtient un objet qui représente la méthode représentée par le délégué spécifié.

Voir aussi

• BackgroundWorker
• Procédure : exécuter une opération en arrière-plan