Прочитать на английском

Поделиться через


EventDescriptorCollection.Item[] Свойство

Определение

Возвращает указанное событие.

Перегрузки

Item[Int32]

Получает или задает событие с указанным номером индекса.

Item[String]

Получает или задает событие с заданным именем.

Item[Int32]

Исходный код:
EventDescriptorCollection.cs
Исходный код:
EventDescriptorCollection.cs
Исходный код:
EventDescriptorCollection.cs

Получает или задает событие с указанным номером индекса.

public virtual System.ComponentModel.EventDescriptor this[int index] { get; }
public virtual System.ComponentModel.EventDescriptor? this[int index] { get; }

Параметры

index
Int32

Индекс (отсчитываемый от нуля) возвращаемого или задаваемого дескриптора EventDescriptor.

Значение свойства

Объект EventDescriptor с заданным индексом.

Исключения

Индекс index не является допустимым для свойства Item[Int32].

Примеры

В следующем примере кода свойство используется для Item[] вывода имени, указанного EventDescriptor номером индекса, в текстовом поле. Так как число индекса отсчитывается от нуля, в этом примере выводится имя второго EventDescriptor. Для этого требуется, чтобы button1 экземпляры и textBox1 были созданы в форме.

private void PrintIndexItem() {
    // Creates a new collection and assigns it the events for button1.
    EventDescriptorCollection events = TypeDescriptor.GetEvents(button1);
 
    // Prints the second event's name.
    textBox1.Text = events[1].ToString();
 }

Комментарии

Номер индекса отсчитывается от нуля. Поэтому необходимо вычесть 1 из числового положения конкретного EventDescriptor объекта, чтобы получить доступ к этой EventDescriptor. Например, чтобы получить третий EventDescriptor, необходимо указать myColl[2].

См. также раздел

Применяется к

Item[String]

Исходный код:
EventDescriptorCollection.cs
Исходный код:
EventDescriptorCollection.cs
Исходный код:
EventDescriptorCollection.cs

Получает или задает событие с заданным именем.

public virtual System.ComponentModel.EventDescriptor this[string name] { get; }

Параметры

name
String

Имя возвращаемого или устанавливаемого дескриптора EventDescriptor.

Значение свойства

Дескриптор EventDescriptor с указанным именем или значение null, если событие не существует.

Примеры

В следующем примере кода свойство используется Item[] для печати типа компонента для указанного EventDescriptor индексом. Для этого требуется, чтобы button1 экземпляры и textBox1 были созданы в форме.

private void PrintIndexItem2() {
    // Creates a new collection and assigns it the events for button1.
    EventDescriptorCollection events = TypeDescriptor.GetEvents(button1);
 
    // Sets an EventDescriptor to the specific event.
    EventDescriptor myEvent = events["KeyDown"];
 
    // Prints the name of the event.
    textBox1.Text = myEvent.Name;
 }

Комментарии

Свойство Item[] учитывает регистр при поиске имен. То есть имена "Ename" и "ename" считаются двумя разными событиями.

Примечание

Атрибут, применяемый HostProtectionAttribute к этому классу, имеет следующее Resources значение свойства: Synchronization. Атрибут HostProtectionAttribute не оказывает влияния на настольные приложения (обычно запускаемые двойным щелчком значка, вводом команды или URL-адреса в браузере). Дополнительные сведения см. в HostProtectionAttribute разделе Класс или SQL Server Атрибуты программирования и защиты узла.

См. также раздел

Применяется к