EventDescriptorCollection 类

项目
08/17/2007

表示 EventDescriptor 对象的集合。

**命名空间:**System.ComponentModel
**程序集:**System（在 system.dll 中）

语法

声明
<ComVisibleAttribute(True)> _
Public Class EventDescriptorCollection
    Implements IList, ICollection, IEnumerable
用法
Dim instance As EventDescriptorCollection

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

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

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

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

备注

EventDescriptorCollection 是只读的；它不实现添加或移除事件的方法。必须从此类继承以实现这些方法。

使用在 EventDescriptorCollection 类中可用的属性，可以对集合内容进行查询。使用 Count 属性确定集合中的元素数。使用 Item 属性按索引号或按名称获取特定属性。

您还可以使用 Find 方法从集合中获取具有指定名称的事件的说明。

提示

应用于此类的 HostProtectionAttribute 属性 (Attribute) 具有以下 Resources 属性 (Property) 值：Synchronization。HostProtectionAttribute 不影响桌面应用程序（桌面应用程序一般通过双击图标，键入命令或在浏览器中输入 URL 启动）。有关更多信息，请参见 HostProtectionAttribute 类或 SQL Server 编程和宿主保护属性。

示例

下面的代码示例在文本框中输出按钮上的所有事件。它要求已在窗体上实例化 button1 和 textBox1。

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';
 }

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

继承层次结构

System.Object
System.ComponentModel.EventDescriptorCollection

线程安全

此类型的任何公共静态（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

通过