EventHandler 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 ein Ereignis behandelt, das keine Ereignisdaten enthält.
public delegate void EventHandler(System::Object ^ sender, EventArgs ^ e);public delegate void EventHandler(object sender, EventArgs e);[System.Serializable]
public delegate void EventHandler(object sender, EventArgs e);[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public delegate void EventHandler(object sender, EventArgs e);type EventHandler = delegate of obj * EventArgs -> unit[<System.Serializable>]
type EventHandler = delegate of obj * EventArgs -> unit[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type EventHandler = delegate of obj * EventArgs -> unitPublic Delegate Sub EventHandler(sender As Object, e As EventArgs)Parameter
- sender
- Object
Die Quelle des Ereignisses.
Ein Objekt, das keine Ereignisdaten enthält.
- Attribute
Hinweise
Das Ereignismodell in .NET basiert auf einem Ereignisdelegat, der ein Ereignis mit seinem Handler verbindet. Zum Auslösen eines Ereignisses sind zwei Elemente erforderlich:
- Ein Delegat, der die Methode identifiziert, die die Antwort auf das Ereignis bereitstellt.
- Optional kann eine Klasse, die die Ereignisdaten enthält, wenn das Ereignis Daten bereitstellt.
Der Delegat ist ein Typ, der eine Signatur definiert, d. h. den Rückgabewerttyp und parameterlistentypen für eine Methode. Sie können den Delegattyp verwenden, um eine Variable zu deklarieren, die auf eine beliebige Methode mit derselben Signatur wie der Delegat verweisen kann.
Die Standardsignatur eines Ereignishandlerdelegats definiert eine Methode, die keinen Wert zurückgibt. Der erste Parameter dieser Methode ist vom Typ Object und verweist auf die Instanz, die das Ereignis auslöst. Der zweite Parameter wird vom Typ EventArgs abgeleitet und enthält die Ereignisdaten. Wenn das Ereignis keine Ereignisdaten generiert, ist der zweite Parameter einfach der Wert des EventArgs.Empty Felds. Andernfalls ist der zweite Parameter ein Typ, der von EventArgs Feldern oder Eigenschaften abgeleitet wird, die zum Halten der Ereignisdaten erforderlich sind.
Der EventHandler Delegat ist ein vordefinierter Delegat, der eine Ereignishandlermethode für ein Ereignis darstellt, das keine Daten generiert. Wenn Ihr Ereignis Daten generiert, müssen Sie die generische EventHandler<TEventArgs> Delegatklasse verwenden.
Um das Ereignis der Methode zuzuordnen, die das Ereignis behandelt, fügen Sie eine Instanz des Delegaten zum Ereignis hinzu. Der Ereignishandler wird immer dann aufgerufen, wenn das Ereignis auftritt, es sei denn, Sie entfernen den Delegaten.
Weitere Informationen zu Ereignishandlerdelegatn finden Sie unter Behandeln und Auslösen von Ereignissen.
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| GetMethodInfo(Delegate) |
Ruft ein Objekt ab, das die vom angegebenen Delegaten dargestellte Methode darstellt. |