DoWorkEventHandler Delegat

Definition

Stellt die Methode zur Behandlung des DoWork-Ereignisses dar.Represents the method that will handle the DoWork event. Diese Klasse kann nicht vererbt werden.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)

Parameter

sender
Object

Die Quelle des Ereignisses.The source of the event.

e
DoWorkEventArgs

Ein DoWorkEventArgs, das die Ereignisdaten enthält.A DoWorkEventArgs that contains the event data.

Vererbung
DoWorkEventHandler

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der DoWorkEventHandler -Delegat verwendet DoWork wird, um das-Ereignis zu behandeln.The following code example demonstrates how to use the DoWorkEventHandler delegate to handle the DoWork event. Eine vollständige Code Auflistung finden Sie unter Gewusst wie: Ausführen eines Vorgangs im Hintergrund.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   

Hinweise

Beim Erstellen eines DoWorkEventHandler-Delegaten bestimmen Sie die Methode für die Ereignisbehandlung.When you create a DoWorkEventHandler delegate, you identify the method that will handle the event. Um dem Ereignishandler das Ereignis zuzuordnen, fügen Sie dem Ereignis eine Instanz des Delegaten hinzu.To associate the event with your event handler, add an instance of the delegate to the event. Die Ereignishandlermethode wird immer dann aufgerufen, wenn das-Ereignis auftritt, wenn Sie den Delegaten nicht entfernen.The event-handler method is called whenever the event occurs, unless you remove the delegate. Weitere Informationen zu Ereignishandlerdelegaten finden Sie unter behandeln und Auswerfen von Ereignissen.For more information about event-handler delegates, see Handling and Raising Events.

Erweiterungsmethoden

GetMethodInfo(Delegate)

Ruft ein Objekt ab, das die Methode darstellt, die vom angegebenen Delegaten dargestellt wird.Gets an object that represents the method represented by the specified delegate.

Gilt für:

Siehe auch