Control.Events Eigenschaft

Definition

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 Clickerstellt, 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.

Gilt für:

Weitere Informationen