Control.Events Control.Events Control.Events Control.Events Property

Definition

Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab.Gets a list of event handler delegates for the control. Diese Eigenschaft ist schreibgeschützt.This property is read-only.

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.The list of event handler delegates.

Beispiele

Im folgenden Beispiel wird ein Ereignis mit dem ClickNamen erstellt, das Handler aus der Auflistung des EventHandlerList Steuer Elements hinzufügt und entfernt, wenn das Ereignis von einer Seite aufgerufen wird.The following example creates an event, named Click, that adds and removes handlers from the control's EventHandlerList collection when the event is called from a page.

Hinweis In diesem Beispiel wird das Hinzufügen und Entfernen von Ereignissen aus der Liste der vom Steuerelement verwalteten Steuerelemente optimiert.Note This example optimizes how a control adds and removes events from the list of them that the control maintains. Wenn Sie ein benutzerdefiniertes Steuerelement erstellen und ein Ereignis definieren möchten, verwenden Sie Code, der diesem ähnelt.If you create custom control and want to define an event, use code similar to this. Diese Technik kann in C#, aber nicht in Visual Basic verwendet werden.This technique can be used in C#, but not 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 hat den Typ EventHandlerList, der einen linearen Suchalgorithmus verwendet, um Einträge in der Liste der Delegaten zu suchen.This property is of type EventHandlerList, which uses a linear search algorithm to find entries in the list of delegates. Ein linearer Suchalgorithmus ist ineffizient, wenn eine große Anzahl von Einträgen funktioniert.A linear search algorithm is inefficient when working with a large number of entries. Wenn Sie also über eine große Liste verfügen, ist die Suche nach Einträgen mit dieser Eigenschaft langsam.Therefore, when you have a large list, finding entries with this property will be slow.

Gilt für:

Siehe auch