Control.Events プロパティ
コントロールのイベント ハンドラ デリゲートのリストを取得します。このプロパティは読み取り専用です。
名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文
'宣言
Protected ReadOnly Property Events As EventHandlerList
'使用
Dim value As EventHandlerList
value = Me.Events
protected EventHandlerList Events { get; }
protected:
property EventHandlerList^ Events {
EventHandlerList^ get ();
}
/** @property */
protected EventHandlerList get_Events ()
protected function get Events () : 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);
}
}
プラットフォーム
Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition
Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。
バージョン情報
.NET Framework
サポート対象 : 3.0,2.0,1.1,1.0