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


コントロールのイベント ハンドラー デリゲートのリストを取得します。Gets a list of event handler delegates for the control. このプロパティは読み取り専用です。This property is read-only.

 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


イベント ハンドラー デリゲートのリスト。The list of event handler delegates.

次の例は、という名前のイベントを作成Clickを追加し、コントロールからハンドラーを削除しますEventHandlerListコレクション ページから、イベントが呼び出されるとします。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.

コントロールの追加し、コントロールを保持するそれらのリストからイベントを削除します。 この例が最適化されます。Note This example optimizes how a control adds and removes events from the list of them that the control maintains. カスタム コントロールを作成してイベントを定義する場合は、次のようにコードを使用します。If you create custom control and want to define an event, use code similar to this. Visual Basic ではなく、C# の場合に、この手法を使用できます。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);


このプロパティの型はEventHandlerList、一方向の検索アルゴリズムを使用するデリゲートの一覧でエントリを検索します。This property is of type EventHandlerList, which uses a linear search algorithm to find entries in the list of delegates. 多数のエントリを使用する場合、一方向の検索アルゴリズムは効率的ではありません。A linear search algorithm is inefficient when working with a large number of entries. そのため、大きなリストがある場合は、このプロパティを持つエントリが速度が遅くなりますを検索します。Therefore, when you have a large list, finding entries with this property will be slow.