Control.Events Eigenschaft
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.
Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt.
protected:
property System::ComponentModel::EventHandlerList ^ Events { System::ComponentModel::EventHandlerList ^ get(); };
protected System.ComponentModel.EventHandlerList Events { get; }
member this.Events : System.ComponentModel.EventHandlerList
Protected ReadOnly Property Events As EventHandlerList
Eigenschaftswert
Die Liste der Ereignishandlerdelegaten.
Beispiele
Im folgenden Beispiel wird ein Ereignis namens Click
erstellt, das Handler hinzufügt und aus der Auflistung des EventHandlerList Steuerelements entfernt, wenn das Ereignis von einer Seite aufgerufen wird.
Hinweis
In diesem Beispiel wird optimiert, wie ein Steuerelement Ereignisse hinzufügt und daraus entfernt, die vom Steuerelement verwaltet werden. Wenn Sie ein benutzerdefiniertes Steuerelement erstellen und ein Ereignis definieren möchten, verwenden Sie code wie diesen. Diese Technik kann in C# verwendet werden, aber nicht in Visual Basic.
// Create an event that adds and removes handlers from the
// Control.Events collection when this event is called from
// a participating page.
public event EventHandler Click {
add {
Events.AddHandler(EventClick, value);
}
remove {
Events.RemoveHandler(EventClick, value);
}
}
Hinweise
Diese Eigenschaft ist vom Typ EventHandlerList, der einen linearen Suchalgorithmus verwendet, um Einträge in der Liste der Delegaten zu finden. Ein linearer Suchalgorithmus ist bei der Arbeit mit einer großen Anzahl von Einträgen ineffizient. Wenn Sie über eine große Liste verfügen, ist es daher langsam, Einträge mit dieser Eigenschaft zu finden.