EventDescriptor-Klasse

Artikel
08/20/2007

Stellt Informationen zu einem Ereignis bereit.

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

Syntax

'Declaration
<ComVisibleAttribute(True)> _
Public MustInherit Class EventDescriptor
    Inherits MemberDescriptor
'Usage
Dim instance As EventDescriptor

[ComVisibleAttribute(true)] 
public abstract class EventDescriptor : MemberDescriptor

[ComVisibleAttribute(true)] 
public ref class EventDescriptor abstract : public MemberDescriptor

/** @attribute ComVisibleAttribute(true) */ 
public abstract class EventDescriptor extends MemberDescriptor

ComVisibleAttribute(true) 
public abstract class EventDescriptor extends MemberDescriptor

Hinweise

Ein EventDescriptor besteht aus einem Namen, seinen Attributen, der Komponente, an die das Ereignis gebunden ist, dem Ereignisdelegaten, dem Typ des Delegaten sowie der Angabe, ob es sich um einen Multicastdelegaten handelt.

EventDescriptor stellt die folgenden abstract-Eigenschaften und -Methoden bereit:

ComponentType enthält den Typ der Komponente, für die dieses Ereignis deklariert wurde.
EventType enthält den Typ des Delegaten für das Ereignis.
IsMulticast enthält einen Wert, der angibt, ob der Ereignisdelegat ein Multicastdelegat ist.
AddEventHandler bindet das Ereignis an eine Komponente.
RemoveEventHandler hebt die Bindung des Delegaten an die Komponente auf, sodass der Delegat von der Komponente keine Ereignisse mehr empfängt.

Weitere Informationen über Ereignisse finden Sie unter Auslösen eines Ereignisses. Weitere Informationen über die Reflektion finden Sie unter den Themen zu Reflektion.

Hinweis

Das auf diese Klasse angewendete HostProtectionAttribute-Attribut besitzt den Resources-Eigenschaftenwert SharedState. 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

Das folgende Codebeispiel basiert auf dem Beispiel in der EventDescriptorCollection-Klasse. Es gibt die Informationen (Kategorie, Beschreibung und Anzeigename) der einzelnen Ereignisse einer Schaltfläche in einem Textfeld aus. Dafür ist es erforderlich, dass button1 und textbox1 in einem Formular instanziiert wurden.

Dim events As EventDescriptorCollection = TypeDescriptor.GetEvents(Button1)
' Displays each event's information in the collection in a text box.
Dim myEvent As EventDescriptor
For Each myEvent In events
    TextBox1.Text &= myEvent.Category & ControlChars.Cr
    TextBox1.Text &= myEvent.Description & ControlChars.Cr
    TextBox1.Text &= myEvent.DisplayName & ControlChars.Cr
Next myEvent

EventDescriptorCollection events = TypeDescriptor.GetEvents(button1);
// Displays each event's information in the collection in a text box.
foreach (System.ComponentModel.EventDescriptor myEvent in events) {
    textBox1.Text += myEvent.Category + '\n';
    textBox1.Text += myEvent.Description + '\n';
    textBox1.Text += myEvent.DisplayName + '\n';
}

EventDescriptorCollection^ events = TypeDescriptor::GetEvents( button1 );

// Displays each event's information in the collection in a text box.
for each (EventDescriptor^ myEvent in events) {
    textBox1->Text += myEvent->Category + '\n';
    textBox1->Text += myEvent->Description + '\n';
    textBox1->Text += myEvent->DisplayName + '\n';
}

EventDescriptorCollection events = TypeDescriptor.GetEvents(button1);
System.ComponentModel.EventDescriptor myEvent = null;
// Displays each event's information in the collection in a text box.
for (int iCtr=0; iCtr < events.get_Count(); iCtr++) {
    myEvent = events.get_Item(iCtr);
    textBox1.set_Text(textBox1.get_Text() + myEvent.get_Category()
        + '\n');
    textBox1.set_Text(textBox1.get_Text() + myEvent.get_Description() 
        + '\n');
    textBox1.set_Text(textBox1.get_Text() + myEvent.get_DisplayName()
        + '\n');
}

Vererbungshierarchie

System.Object
System.ComponentModel.MemberDescriptor
System.ComponentModel.EventDescriptor

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

EventDescriptor-Member
System.ComponentModel-Namespace
MemberDescriptor
Attribute

Freigeben über