EventDescriptorCollection 类

定义

命名空间:

System.ComponentModel

程序集:

System.ComponentModel.TypeConverter.dll

Source:

EventDescriptorCollection.cs

表示 EventDescriptor 对象集合。

public ref class EventDescriptorCollection : System::Collections::IList

public class EventDescriptorCollection : System.Collections.IList

type EventDescriptorCollection = class
    interface ICollection
    interface IEnumerable
    interface IList

Public Class EventDescriptorCollection
Implements IList

继承

Object

EventDescriptorCollection

实现

ICollection IEnumerable IList

示例

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

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);
 
    // Displays each event in the collection in a text box.
    foreach (EventDescriptor myEvent in events)
       textBox1.Text += myEvent.Name + '\n';
 }

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

注解

EventDescriptorCollection 为只读;它不实现添加或删除事件的方法。 必须从此类继承才能实现这些方法。

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

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

构造函数

EventDescriptorCollection(EventDescriptor[])	用给定的 EventDescriptorCollection 对象的数组初始化 EventDescriptor 类的新实例。
EventDescriptorCollection(EventDescriptor[], Boolean)	用给定的 EventDescriptorCollection 对象的数组初始化 EventDescriptor 类的新实例。 该集合可以是只读的。

字段

Empty

指定要使用的空集合，而不是创建不具有任何项的新集合。 此 static 字段是只读的。

属性

Count	获取集合中事件说明符的数目。
Item[Int32]	获取或设置具有指定索引号的事件。
Item[String]	获取或设置具有指定名称的事件。

方法

Add(EventDescriptor)	将 EventDescriptor 添加到集合的末尾。
Clear()	从集合中删除所有对象。
Contains(EventDescriptor)	返回集合是否包含给定的 EventDescriptor。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
Find(String, Boolean)	获取集合中具有指定名称的事件的说明。
GetEnumerator()	获取此 EventDescriptorCollection 的枚举器。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
IndexOf(EventDescriptor)	返回给定 EventDescriptor 的索引。
Insert(Int32, EventDescriptor)	将 EventDescriptor 插入集合中指定的索引位置。
InternalSort(IComparer)	使用指定的 EventDescriptorCollection 将此 IComparer 的成员排序。
InternalSort(String[])	将此 EventDescriptorCollection 的成员排序。 首先应用指定的顺序，然后应用此集合的默认排序，后者通常为字母顺序。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
Remove(EventDescriptor)	从集合中移除指定的 EventDescriptor。
RemoveAt(Int32)	从集合中移除指定索引位置的 EventDescriptor。
Sort()	使用集合的默认排序（通常为字母顺序）对此 EventDescriptorCollection 的成员进行排序。
Sort(IComparer)	使用指定的 EventDescriptorCollection 将此 IComparer 的成员排序。
Sort(String[])	按照指定的排序顺序对此 EventDescriptorCollection 的成员进行排序。
Sort(String[], IComparer)	按照指定的排序顺序和 EventDescriptorCollection 对此 IComparer 的成员进行排序。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

ICollection.CopyTo(Array, Int32)	将该集合的元素复制到 Array（从特定的 Array 索引开始）。
ICollection.Count	获取集合中包含的元素数。
ICollection.IsSynchronized	获取一个值，该值指示是否同步对集合的访问。
ICollection.SyncRoot	获取可用于同步对集合的访问的对象。
IEnumerable.GetEnumerator()	返回循环访问集合的枚举数。
IList.Add(Object)	向集合中添加一项。
IList.Clear()	从集合中移除所有项。
IList.Contains(Object)	确定集合中是否包含特定值。
IList.IndexOf(Object)	确定集合中特定项的索引。
IList.Insert(Int32, Object)	将某个项插入到集合中的指定索引处。
IList.IsFixedSize	获取一个值，该值指示集合是否具有固定大小。
IList.IsReadOnly	获取一个值，该值指示集合是否为只读。
IList.Item[Int32]	获取或设置指定索引处的元素。
IList.Remove(Object)	从集合中移除特定对象的第一个匹配项。
IList.RemoveAt(Int32)	删除指定索引处的项。

扩展方法

Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定的类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。

另请参阅

• EventDescriptor
• TypeDescriptor