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

Определение

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

System.ComponentModel

Сборка:

System.ComponentModel.TypeConverter.dll

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

Перегрузки

Item[Int32]	Получает или задает событие с указанным номером индекса.
Item[String]	Получает или задает событие с заданным именем.

Item[Int32]

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

EventDescriptorCollection.cs

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

public:
 virtual property System::ComponentModel::EventDescriptor ^ default[int] { System::ComponentModel::EventDescriptor ^ get(int index); };

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

member this.Item(int) : System.ComponentModel.EventDescriptor

Default Public Overridable ReadOnly Property Item(index As Integer) As EventDescriptor

Параметры

index

Int32

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

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

EventDescriptor

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

Исключения

IndexOutOfRangeException

Индекс 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();
   }

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

Private Sub PrintIndexItem()
    ' Creates a new collection and assigns it the events for button1.
    Dim events As EventDescriptorCollection = TypeDescriptor.GetEvents(button1)
    
    ' Prints the second event's name.
    textBox1.Text = events(1).ToString()
End Sub

Комментарии

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

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

• EventDescriptor
• TypeDescriptor

Item[String]

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

EventDescriptorCollection.cs

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

public:
 virtual property System::ComponentModel::EventDescriptor ^ default[System::String ^] { System::ComponentModel::EventDescriptor ^ get(System::String ^ name); };

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

member this.Item(string) : System.ComponentModel.EventDescriptor

Default Public Overridable ReadOnly Property Item(name As String) As EventDescriptor

Параметры

name

String

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

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

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

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

Private Sub PrintIndexItem2()
    ' Creates a new collection and assigns it the events for button1.
    Dim events As EventDescriptorCollection = TypeDescriptor.GetEvents(button1)
    
    ' Sets an EventDescriptor to the specific event.
    Dim myEvent As EventDescriptor = events("KeyDown")
    
    ' Prints the name of the event.
    textBox1.Text = myEvent.Name
End Sub

Комментарии

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

Примечание

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

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

• EventDescriptor
• TypeDescriptor