EventDescriptorCollection.Item[] Eigenschaft

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Ruft das angegebene Ereignis ab.

Überlädt

Item[Int32]	Ruft das Ereignis mit der angegebenen Indexnummer ab oder legt dieses fest.
Item[String]	Ruft das Ereignis mit dem angegebenen Namen ab oder legt dieses fest.

Item[Int32]

Quelle:

EventDescriptorCollection.cs

Ruft das Ereignis mit der angegebenen Indexnummer ab oder legt dieses fest.

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

Parameter

index

Int32

Die nullbasierte Indexnummer des EventDescriptor, der abgerufen oder festgelegt werden soll.

Eigenschaftswert

EventDescriptor

Die EventDescriptor-Klasse mit der angegebenen Indexnummer.

Ausnahmen

IndexOutOfRangeException

index ist kein gültiger Index für Item[Int32].

Beispiele

Im folgenden Codebeispiel wird die Item[] -Eigenschaft verwendet, um den namen der EventDescriptor durch die Indexnummer angegebenen in einem Textfeld auszudrucken. Da die Indexnummer nullbasiert ist, wird in diesem Beispiel der Name des zweiten EventDescriptorausgegeben. Es erfordert, dass und button1textBox1 auf einem Formular instanziiert wurde.

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

Hinweise

Die Indexnummer ist nullbasiert. Daher müssen Sie 1 von der numerischen Position einer bestimmten EventDescriptor subtrahieren, um auf diese EventDescriptorzuzugreifen. Um z. B. den dritten EventDescriptorzu erhalten, müssen Sie angeben myColl[2].

Weitere Informationen

• EventDescriptor
• TypeDescriptor

Item[String]

Quelle:

EventDescriptorCollection.cs

Ruft das Ereignis mit dem angegebenen Namen ab oder legt dieses fest.

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

Parameter

name

String

Der Name des abzurufenden oder festzulegenden EventDescriptor.

Eigenschaftswert

EventDescriptor

Die EventDescriptor-Klasse mit dem angegebenen Namen oder null, wenn das Ereignis nicht vorhanden ist.

Beispiele

Im folgenden Codebeispiel wird die Item[] -Eigenschaft verwendet, um den Typ der Komponente für die EventDescriptor durch den Index angegebene zu drucken. Es erfordert, dass und button1textBox1 auf einem Formular instanziiert wurde.

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

Hinweise

Bei der Item[] Eigenschaft wird bei der Suche nach Namen die Groß-/Kleinschreibung beachtet. Das heißt, die Namen "Ename" und "ename" werden als zwei verschiedene Ereignisse betrachtet.

Hinweis

Das HostProtectionAttribute Attribut, das auf diese Klasse angewendet wird, weist den folgenden Resources Eigenschaftswert auf: Synchronization. Das HostProtectionAttribute hat keine Auswirkungen auf Desktopanwendungen (die normalerweise durch Doppelklicken auf ein Symbol, Eingeben eines Befehls oder einer URL in einem Browser gestartet werden). Weitere Informationen finden Sie in der HostProtectionAttribute Klasse oder SQL Server Programming and Host Protection Attribute.

Weitere Informationen

• EventDescriptor
• TypeDescriptor