DoWorkEventHandler Délégué

Définition

Espace de noms:

System.ComponentModel

Assemblys:

netstandard.dll, System.ComponentModel.EventBasedAsync.dll

Source:

DoWorkEvent.cs

Représente la méthode qui gère 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

Qui DoWorkEventArgs 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 la liste complète du code, consultez Guide pratique pour exécuter une opération en arrière-plan.

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 DoWorkEventHandler délégué, vous identifiez la méthode qui gère l’événement. Pour associer l’événement à votre 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

Nom	Description
GetMethodInfo(Delegate)	Obtient un objet qui représente la méthode représentée par le délégué spécifié.

Voir aussi

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