AsyncCompletedEventHandler Delegat
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt die Methode dar, die das MethodName-EreignisCompleted
eines asynchronen Vorgangs behandelt.
public delegate void AsyncCompletedEventHandler(System::Object ^ sender, AsyncCompletedEventArgs ^ e);
public delegate void AsyncCompletedEventHandler(object sender, AsyncCompletedEventArgs e);
public delegate void AsyncCompletedEventHandler(object? sender, AsyncCompletedEventArgs e);
type AsyncCompletedEventHandler = delegate of obj * AsyncCompletedEventArgs -> unit
Public Delegate Sub AsyncCompletedEventHandler(sender As Object, e As AsyncCompletedEventArgs)
Parameter
- sender
- Object
Die Quelle des Ereignisses.
Ein AsyncCompletedEventArgs, das die Ereignisdaten enthält.
Beispiele
Ein Codebeispiel für den AsyncCompletedEventHandler Delegaten finden Sie im Beispiel in der System.ComponentModel.AsyncCompletedEventArgs -Klasse.
Hinweise
Beim Erstellen eines AsyncCompletedEventHandler-Delegaten geben Sie die Methode für die Ereignisbehandlung an. Um dem Ereignishandler das Ereignis zuzuordnen, fügen Sie dem Ereignis eine Instanz des Delegaten hinzu. Die Ereignishandlermethode wird immer aufgerufen, wenn das Ereignis auftritt, es sei denn, Sie entfernen den Delegaten. Weitere Informationen zu Ereignishandlerdelegaten finden Sie unter Behandeln und Auslösen von Ereignissen.
Für eine asynchrone Methode namens MethodName verfügen Sie in Ihrer Komponente über ein entsprechendes MethodName-EreignisCompleted
und eine optionale MethodName-KlasseCompletedEventArgs
.
Für eine Komponente, die mehrere gleichzeitige Aufrufe ihrer asynchronen Methoden unterstützt, kann der Client ein eindeutiges Token oder eine Aufgaben-ID bereitstellen, um zu unterscheiden, welche asynchrone Aufgabe bestimmte Ereignisse auslöst. Der Client AsyncCompletedEventHandler kann die AsyncCompletedEventArgs.UserState -Eigenschaft lesen, um zu bestimmen, welche Aufgabe den Abschluss meldet. Ihre Implementierung sollte verwenden System.ComponentModel.AsyncOperationManager , um eine System.ComponentModel.AsyncOperation zu erstellen, die die Aufgaben-IDs des Clients ausstehenden asynchronen Aufgaben zuordnet.
Erweiterungsmethoden
GetMethodInfo(Delegate) |
Ruft ein Objekt ab, das die Methode darstellt, die vom angegebenen Delegaten dargestellt wird. |