EventDescriptorCollection-Klasse

Artikel
08/20/2007

Stellt eine Auflistung von EventDescriptor-Objekten dar.

Namespace: System.ComponentModel
Assembly: System (in system.dll)

Syntax

'Declaration
<ComVisibleAttribute(True)> _
Public Class EventDescriptorCollection
    Implements IList, ICollection, IEnumerable
'Usage
Dim instance As EventDescriptorCollection

[ComVisibleAttribute(true)] 
public class EventDescriptorCollection : IList, ICollection, IEnumerable

[ComVisibleAttribute(true)] 
public ref class EventDescriptorCollection : IList, ICollection, IEnumerable

/** @attribute ComVisibleAttribute(true) */ 
public class EventDescriptorCollection implements IList, ICollection, 
    IEnumerable

ComVisibleAttribute(true) 
public class EventDescriptorCollection implements IList, ICollection, 
    IEnumerable

Hinweise

EventDescriptorCollection ist schreibgeschützt und implementiert keine Methoden zum Hinzufügen oder Entfernen von Ereignissen. Sie müssen diese Klasse vererben, um diese Methoden zu implementieren.

Den Inhalt der Auflistung können Sie mithilfe der in der EventDescriptorCollection-Klasse verfügbaren Eigenschaften abfragen. Mit der Count-Eigenschaft können Sie die Anzahl der Elemente in der Auflistung bestimmen. Mit der Item-Eigenschaft können Sie eine bestimmte Eigenschaft nach Indexnummer oder Namen abrufen.

Außerdem können Sie mit der Find-Methode eine Beschreibung des Ereignisses mit dem angegebenen Namen aus der Auflistung abrufen.

Hinweis

Das auf diese Klasse angewendete HostProtectionAttribute-Attribut besitzt den Resources-Eigenschaftenwert Synchronization. Das HostProtectionAttribute hat keine Auswirkungen auf Desktopanwendungen (die normalerweise durch Doppelklicken auf ein Symbol, Eingeben eines Befehls oder eines URL in einem Browser gestartet werden). Weitere Informationen finden Sie unter der HostProtectionAttribute-Klasse oder unter SQL Server-Programmierung und Hostschutzattribute.

Beispiel

Im folgenden Codebeispiel werden alle Ereignisse für eine Schaltfläche in einem Textfeld ausgegeben. Dafür ist es erforderlich, dass button1 und textBox1 in einem Formular instanziiert wurden.

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 'MyEventCollection

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:
   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);

    for (int iCtr = 0; iCtr < events.get_Count(); iCtr++) {
        EventDescriptor myEvent = events.get_Item(iCtr);
        // Displays each event in the collection in a text box.
        textBox1.set_Text(textBox1.get_Text() + myEvent.get_Name() + '\n');
    }
} //MyEventCollection

Vererbungshierarchie

System.Object
System.ComponentModel.EventDescriptorCollection

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

EventDescriptorCollection-Member
System.ComponentModel-Namespace
EventDescriptor-Klasse
TypeDescriptor

Freigeben über