EventDescriptorCollection

.NET Framework クラス ライブラリ リファレンス

EventDescriptorCollection クラス

EventDescriptor オブジェクトのコレクションを表します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public Class EventDescriptorCollection
    Implements IList, ICollection, IEnumerable

Visual Basic (使用法)

Dim instance As EventDescriptorCollection

C#

[ComVisibleAttribute(true)] 
public class EventDescriptorCollection : IList,
 ICollection, IEnumerable

C++

[ComVisibleAttribute(true)] 
public ref class EventDescriptorCollection
 : IList, ICollection, IEnumerable

J#

/** @attribute ComVisibleAttribute(true) */ 
public class EventDescriptorCollection implements
 IList, ICollection, 
    IEnumerable

JScript

ComVisibleAttribute(true) 
public class EventDescriptorCollection implements
 IList, ICollection, 
    IEnumerable

解説

EventDescriptorCollection は読み取り専用であり、イベントを追加または削除するためのメソッドは実装していません。これらのメソッドを実装するには、このクラスから継承する必要があります。

EventDescriptorCollection クラスで利用できるプロパティを使用して、コレクションに対してその内容を照会できます。コレクション内の要素の数を確認するには、Count プロパティを使用します。インデックス番号または名前で指定したプロパティを取得するには、Item プロパティを使用します。

また、Find メソッドを使用して、指定した名前のイベントの説明をコレクションから取得できます。

メモ
このクラスに適用される HostProtectionAttribute 属性の Resources プロパティの値は、Synchronization です。HostProtectionAttribute は、デスクトップ アプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

使用例

ボタンにかかわるイベントをすべてテキスト ボックスに出力するコード例を次に示します。この例では、button1 と textBox1 がフォーム上でインスタンス化されていることが必要です。

Visual Basic

Private Sub MyEventCollection()
    ' Creates a new collection and assigns it the events for button1.
    Dim events As EventDescriptorCollection
 = TypeDescriptor.GetEvents(button1)
    
    ' Displays each event in the collection in a text box.
    Dim myEvent As EventDescriptor
    For Each myEvent In
  events
        textBox1.Text &= myEvent.Name & ControlChars.Cr
    Next myEvent
End Sub 'MyEventCollection 

C#

private void MyEventCollection() {
    // Creates a new collection and assigns it the events for button1.
    EventDescriptorCollection events = TypeDescriptor.GetEvents(button1);
 
    // Displays each event in the collection in a text box.
    foreach (EventDescriptor myEvent in events)
       textBox1.Text += myEvent.Name + '\n';
 }

C++

private:
   void MyEventCollection()
   {
      // Creates a new collection and assigns it the events for button1.
      EventDescriptorCollection^ events = TypeDescriptor::GetEvents( button1 );
      
      // Displays each event in the collection in a text box.
      for each ( EventDescriptor^ myEvent in
 events )
      {
         textBox1->Text = String::Concat( textBox1->Text, myEvent->Name,
 "\n" );
      }
   }

J#

private void MyEventCollection()
{
    // Creates a new collection and assigns it the events for button1.
    EventDescriptorCollection events = TypeDescriptor.GetEvents(button1);

    for (int iCtr = 0; iCtr < events.get_Count();
 iCtr++) {
        EventDescriptor myEvent = events.get_Item(iCtr);
        // Displays each event in the collection in a text box.
        textBox1.set_Text(textBox1.get_Text() + myEvent.get_Name() + '\n');
    }
} //MyEventCollection

継承階層

System.Object
  System.ComponentModel.EventDescriptorCollection

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
EventDescriptorCollection メンバ
System.ComponentModel 名前空間
EventDescriptor クラス
TypeDescriptor

EventDescriptorCollection コンストラクタ (EventDescriptor[])

EventDescriptor オブジェクトの配列を指定して、EventDescriptorCollection クラスの新しいインスタンスを初期化します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    events As EventDescriptor() _
)

Visual Basic (使用法)

Dim events As EventDescriptor()

Dim instance As New EventDescriptorCollection(events)

C#

public EventDescriptorCollection (
    EventDescriptor[] events
)

C++

public:
EventDescriptorCollection (
    array<EventDescriptor^>^ events
)

J#

public EventDescriptorCollection (
    EventDescriptor[] events
)

JScript

public function EventDescriptorCollection (
    events : EventDescriptor[]
)

パラメータ

events

コレクションにイベントを提供する、EventDescriptor 型の配列。

解説

events パラメータが空の場合、このコンストラクタは空の EventDescriptorCollection クラスを作成します。

このメンバに適用される HostProtectionAttribute 属性の Resources プロパティの値は、Synchronization です。HostProtectionAttribute は、デスクトップ アプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

使用例

button1 のイベントを使用して、新しい EventDescriptorCollection クラスを作成するコード例を次に示します。この例では、button1 がフォーム上でインスタンス化されていることが必要です。

Visual Basic

Dim events As EventDescriptorCollection = TypeDescriptor.GetEvents(button1)

C#

EventDescriptorCollection events = TypeDescriptor.GetEvents(button1);

C++

EventDescriptorCollection^ events = TypeDescriptor::GetEvents( button1 );

J#

EventDescriptorCollection events = TypeDescriptor.GetEvents(button1);

プラットフォーム

Windows 98, Windows 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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
EventDescriptorCollection クラス
EventDescriptorCollection メンバ
System.ComponentModel 名前空間
EventDescriptor クラス
TypeDescriptor

EventDescriptorCollection コンストラクタ

EventDescriptorCollection クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
EventDescriptorCollection (EventDescriptor[])	EventDescriptor オブジェクトの配列を指定して、EventDescriptorCollection クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
EventDescriptorCollection (EventDescriptor[], Boolean)	EventDescriptor オブジェクトの配列を指定して、EventDescriptorCollection クラスの新しいインスタンスを初期化します。このコレクションは、オプションで読み取り専用にできます。

参照

関連項目

EventDescriptorCollection クラス
EventDescriptorCollection メンバ
System.ComponentModel 名前空間
EventDescriptor クラス
TypeDescriptor

EventDescriptorCollection コンストラクタ (EventDescriptor[], Boolean)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

EventDescriptor オブジェクトの配列を指定して、EventDescriptorCollection クラスの新しいインスタンスを初期化します。このコレクションは、オプションで読み取り専用にできます。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    events As EventDescriptor(), _
    readOnly As Boolean
 _
)

Visual Basic (使用法)

Dim events As EventDescriptor()
Dim readOnly As Boolean

Dim instance As New EventDescriptorCollection(events,
 readOnly)

C#

public EventDescriptorCollection (
    EventDescriptor[] events,
    bool readOnly
)

C++

public:
EventDescriptorCollection (
    array<EventDescriptor^>^ events, 
    bool readOnly
)

J#

public EventDescriptorCollection (
    EventDescriptor[] events, 
    boolean readOnly
)

JScript

public function EventDescriptorCollection (
    events : EventDescriptor[], 
    readOnly : boolean
)

パラメータ

events

コレクションにイベントを提供する、EventDescriptor 型の配列。

readOnly

コレクションを読み取り専用に指定する場合は true。それ以外の場合は false。

解説

events パラメータが空の場合、このコンストラクタは空の EventDescriptorCollection クラスを作成します。

メモ
このクラスに適用される HostProtectionAttribute 属性の Resources プロパティの値は、Synchronization です。HostProtectionAttribute は、デスクトップ アプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

使用例

button1 のイベントを使用して、新しい EventDescriptorCollection クラスを作成するコード例を次に示します。この例では、button1 がフォーム上でインスタンス化されていることが必要です。

Visual Basic

Dim events As EventDescriptorCollection = TypeDescriptor.GetEvents(button1)

C#

EventDescriptorCollection events = TypeDescriptor.GetEvents(button1);

C++

EventDescriptorCollection^ events = TypeDescriptor::GetEvents( button1 );

J#

EventDescriptorCollection events = TypeDescriptor.GetEvents(button1);

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
EventDescriptorCollection クラス
EventDescriptorCollection メンバ
System.ComponentModel 名前空間
EventDescriptor クラス
TypeDescriptor

EventDescriptorCollection フィールド

パブリック フィールド

	名前	説明
	Empty	項目が格納されていないコレクションを新規作成するのではなく、空のコレクションを使用することを指定します。static フィールドは読み取り専用です。

参照

関連項目

EventDescriptorCollection クラス
System.ComponentModel 名前空間
EventDescriptor クラス
TypeDescriptor

EventDescriptorCollection プロパティ

パブリック プロパティ

	名前	説明
	Item	オーバーロードされます。 指定したイベントを取得します。

明示的インターフェイスの実装

	名前	説明
	System.Collections.IList.Item	指定したインデックスにある要素を取得または設定します。

参照

関連項目

EventDescriptorCollection クラス
System.ComponentModel 名前空間
EventDescriptor クラス
TypeDescriptor

EventDescriptorCollection メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Add	コレクションの末尾に EventDescriptor を追加します。
	Clear	コレクションからすべてのオブジェクトを削除します。
	Contains	指定した EventDescriptor がコレクションに格納されているかどうかを示す値を返します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	Find	コレクション内の指定した名前を持つイベントの説明を取得します。
	GetEnumerator	EventDescriptorCollection の列挙子を取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IndexOf	指定した EventDescriptor のインデックスを返します。
	Insert	コレクション内の指定したインデックス位置に EventDescriptor を挿入します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Remove	指定した EventDescriptor をコレクションから削除します。
	RemoveAt	指定したインデックス位置にある EventDescriptor をコレクションから削除します。
	Sort	オーバーロードされます。 EventDescriptorCollection のメンバを並べ替えます。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	InternalSort	オーバーロードされます。 EventDescriptorCollection のメンバを並べ替えます。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

明示的インターフェイスの実装

	名前	説明
	System.Collections.ICollection.CopyTo	コレクションの要素を Array にコピーします。Array の特定のインデックスからコピーが開始されます。
	System.Collections.IEnumerable.GetEnumerator	コレクションを反復処理する列挙子を返します。
	System.Collections.IList.Add	項目をコレクションに追加します。
	System.Collections.IList.Clear	コレクションからすべての項目を削除します。
	System.Collections.IList.Contains	コレクションに特定の値が格納されているかどうかを判断します。
	System.Collections.IList.IndexOf	コレクション内での指定した項目のインデックスを調べます。
	System.Collections.IList.Insert	コレクション内の指定したインデックスの位置に項目を挿入します。
	System.Collections.IList.Remove	最初に見つかった特定のオブジェクトをコレクションから削除します。
	System.Collections.IList.RemoveAt	指定したインデックスにある項目を削除します。

参照

関連項目

EventDescriptorCollection クラス
System.ComponentModel 名前空間
EventDescriptor クラス
TypeDescriptor

EventDescriptorCollection メンバ

EventDescriptor オブジェクトのコレクションを表します。

EventDescriptorCollection データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	EventDescriptorCollection	オーバーロードされます。 EventDescriptorCollection クラスの新しいインスタンスを初期化します。

パブリック フィールド

	名前	説明
	Empty	項目が格納されていないコレクションを新規作成するのではなく、空のコレクションを使用することを指定します。static フィールドは読み取り専用です。

パブリック プロパティ

	名前	説明
	Item	オーバーロードされます。 指定したイベントを取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Add	コレクションの末尾に EventDescriptor を追加します。
	Clear	コレクションからすべてのオブジェクトを削除します。
	Contains	指定した EventDescriptor がコレクションに格納されているかどうかを示す値を返します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	Find	コレクション内の指定した名前を持つイベントの説明を取得します。
	GetEnumerator	EventDescriptorCollection の列挙子を取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IndexOf	指定した EventDescriptor のインデックスを返します。
	Insert	コレクション内の指定したインデックス位置に EventDescriptor を挿入します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Remove	指定した EventDescriptor をコレクションから削除します。
	RemoveAt	指定したインデックス位置にある EventDescriptor をコレクションから削除します。
	Sort	オーバーロードされます。 EventDescriptorCollection のメンバを並べ替えます。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	InternalSort	オーバーロードされます。 EventDescriptorCollection のメンバを並べ替えます。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

明示的インターフェイスの実装

	名前	説明
	System.Collections.ICollection.CopyTo	コレクションの要素を Array にコピーします。Array の特定のインデックスからコピーが開始されます。
	System.Collections.IEnumerable.GetEnumerator	コレクションを反復処理する列挙子を返します。
	System.Collections.IList.Add	項目をコレクションに追加します。
	System.Collections.IList.Clear	コレクションからすべての項目を削除します。
	System.Collections.IList.Contains	コレクションに特定の値が格納されているかどうかを判断します。
	System.Collections.IList.IndexOf	コレクション内での指定した項目のインデックスを調べます。
	System.Collections.IList.Insert	コレクション内の指定したインデックスの位置に項目を挿入します。
	System.Collections.IList.Remove	最初に見つかった特定のオブジェクトをコレクションから削除します。
	System.Collections.IList.RemoveAt	指定したインデックスにある項目を削除します。
	System.Collections.IList.Item	指定したインデックスにある要素を取得または設定します。

参照

関連項目

EventDescriptorCollection クラス
System.ComponentModel 名前空間
EventDescriptor クラス
TypeDescriptor