EventDescriptorCollection Класс

Определение

Пространство имен:

System.ComponentModel

Сборка:

System.ComponentModel.TypeConverter.dll

Исходный код:

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