EventDescriptorCollection.Item[] Propriedade

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Obtém o evento especificado.

Sobrecargas

Item[Int32]	Obtém ou define o evento com o número de índice especificado.
Item[String]	Obtém ou define o evento com o nome especificado.

Item[Int32]

Origem:

EventDescriptorCollection.cs

Obtém ou define o evento com o número de índice especificado.

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

Parâmetros

index

Int32

O número do índice de base zero do EventDescriptor a ser obtido ou definido.

Valor da propriedade

EventDescriptor

O EventDescriptor com o número de índice especificado.

Exceções

IndexOutOfRangeException

index não é um índice válido para Item[Int32].

Exemplos

O exemplo de código a seguir usa a Item[] propriedade para imprimir o nome do EventDescriptor especificado pelo número de índice em uma caixa de texto. Como o número de índice é baseado em zero, este exemplo imprime o nome do segundo EventDescriptor. Requer isso button1 e textBox1 ter sido instanciado em um formulário.

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

Comentários

O número do índice é baseado em zero. Portanto, você deve subtrair 1 da posição numérica de um determinado EventDescriptor para acessar esse EventDescriptor. Por exemplo, para obter o terceiro EventDescriptor, você precisa especificar myColl[2].

Confira também

• EventDescriptor
• TypeDescriptor

Item[String]

Origem:

EventDescriptorCollection.cs

Obtém ou define o evento com o nome especificado.

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

Parâmetros

name

String

O nome do EventDescriptor a ser obtido ou definido.

Valor da propriedade

EventDescriptor

O EventDescriptor com o nome especificado ou null, se o evento não existir.

Exemplos

O exemplo de código a seguir usa a Item[] propriedade para imprimir o tipo do componente para o EventDescriptor especificado pelo índice. Requer isso button1 e textBox1 ter sido instanciado em um formulário.

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

Comentários

A Item[] propriedade diferencia maiúsculas de minúsculas ao pesquisar nomes. Ou seja, os nomes "Ename" e "ename" são considerados dois eventos diferentes.

Observação

O HostProtectionAttribute atributo aplicado a essa classe tem o seguinte Resources valor de propriedade: Synchronization. HostProtectionAttribute não afeta aplicativos de área de trabalho (que são normalmente iniciados com o clique duplo em um ícone, a digitação de um comando ou a inserção de uma URL em um navegador). Para obter mais informações, consulte a HostProtectionAttribute classe ou SQL Server Atributos de Programação e Proteção de Host.

Confira também

• EventDescriptor
• TypeDescriptor