Control.Events プロパティ

定義

コントロールのイベント ハンドラー デリゲートのリストを取得します。 このプロパティは読み取り専用です。

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

プロパティ値

EventHandlerList

イベント ハンドラー デリゲートのリスト。

次の例では、という名前のイベントを作成し Click ます。これは、 EventHandlerList ページからイベントが呼び出されたときに、コントロールのコレクションからハンドラーを追加および削除します。

注意

この例では、コントロールが保持するイベントの一覧から、コントロールによってイベントが追加および削除される方法を最適化します。 カスタムコントロールを作成し、イベントを定義する場合は、次のようなコードを使用します。 この手法は C# では使用できますが、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 で、線形検索アルゴリズムを使用してデリゲートのリスト内のエントリを検索します。 大量のエントリを処理する場合、線形検索アルゴリズムは非効率的です。 このため、リストが大きい場合は、このプロパティを使用してエントリを検索すると処理速度が低下します。

適用対象

こちらもご覧ください