DoWorkEventHandler Délégué

Définition

Représente la méthode qui gérera l'événement DoWork.Represents the method that will handle the DoWork event. Cette classe ne peut pas être héritée.This class cannot be inherited.

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.The source of the event.

e
DoWorkEventArgs

DoWorkEventArgs qui contient les données d'événement.A DoWorkEventArgs that contains the event data.

Héritage
DoWorkEventHandler

Exemples

L’exemple de code suivant montre comment utiliser le DoWorkEventHandler délégué pour gérer l' DoWork événement.The following code example demonstrates how to use the DoWorkEventHandler delegate to handle the DoWork event. Pour obtenir une liste complète du code , consultez Procédure: exécuter une opération en arrière-plan.For a full code listing, see How to: Run an Operation in the Background.

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.When you create a DoWorkEventHandler delegate, you identify the method that will handle the event. Pour associer l'événement au gestionnaire d'événements, ajoutez une instance du délégué à l'événement.To associate the event with your event handler, add an instance of the delegate to the event. 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é.The event-handler method is called whenever the event occurs, unless you remove the delegate. Pour plus d’informations sur les délégués de gestionnaires d’événements, consultez gestion et déclenchement d’événements.For more information about event-handler delegates, see Handling and Raising Events.

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é.Gets an object that represents the method represented by the specified delegate.

S’applique à

Voir aussi