EventDescriptorCollection クラスとは何？わかりやすく解説 Weblio辞書

.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

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

C++

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

/** @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 プログラミングとホスト保護属性」を参照してください。

メモ

このクラスに適用される 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

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" );
      }
   }

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