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 Ereignishandlerdelegatten 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.EventHandlerListProtected ReadOnly Property Events As EventHandlerListEigenschaftswert
Die Liste der Ereignishandlerdelegat.
Beispiele
Im folgenden Beispiel wird ein Ereignis namens erstellt Click, das Handler aus der Auflistung des Steuerelements EventHandlerList hinzufügt und entfernt, wenn das Ereignis von einer Seite aufgerufen wird.
Note
In diesem Beispiel wird optimiert, wie ein Steuerelement Ereignisse aus der Liste hinzufügt und entfernt, die das Steuerelement verwaltet. Wenn Sie ein benutzerdefiniertes Steuerelement erstellen und ein Ereignis definieren möchten, verwenden Sie code ähnlich diesem. 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, die einen linearen Suchalgorithmus verwendet, um Einträge in der Liste der Stellvertretungen zu finden. Ein linearer Suchalgorithmus ist bei der Arbeit mit einer großen Anzahl von Einträgen ineffizient. Daher ist das Auffinden von Einträgen mit dieser Eigenschaft langsam, wenn Sie über eine große Liste verfügen.