EventDescriptor Klasse

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Enthält Informationen über ein Ereignis.

public ref class EventDescriptor abstract : System::ComponentModel::MemberDescriptor

public abstract class EventDescriptor : System.ComponentModel.MemberDescriptor

type EventDescriptor = class
    inherit MemberDescriptor

Public MustInherit Class EventDescriptor
Inherits MemberDescriptor

Vererbung

Object

MemberDescriptor

EventDescriptor

Beispiele

Das folgende Codebeispiel basiert auf dem Beispiel in der EventDescriptorCollection -Klasse. Es druckt die Informationen (Kategorie, Beschreibung und Anzeigename) jedes Ereignisses auf einer Schaltfläche in einem Textfeld aus. Es erfordert, dass und button1textbox1 auf einem Formular instanziiert wurde.

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);
// 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';
}

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

Hinweise

Ein EventDescriptor besteht aus einem Namen, seinen Attributen, der Komponente, an die das Ereignis gebunden ist, dem Ereignisdelegat, dem Typ des Delegaten und der Angabe, ob der Delegat Multicast ist.

EventDescriptor stellt die folgenden abstract Eigenschaften und Methoden bereit:

• ComponentType enthält den Typ der Komponente, für die dieses Ereignis deklariert wird.

• EventType enthält den Typ des Delegaten für das Ereignis.

• IsMulticast enthält einen Wert, der angibt, ob es sich bei dem Ereignisdelegat um einen Multicastdelegat handelt.

• AddEventHandler bindet das Ereignis an eine Komponente.

• RemoveEventHandler Hebt die Bindung des Delegaten an die Komponente auf, sodass der Delegat keine Ereignisse mehr von der Komponente empfängt.

Weitere Informationen zu Ereignissen finden Sie unter Behandeln und Auslösen von Ereignissen. Weitere Informationen zur Reflexion finden Sie in den Themen in Reflexion.

Konstruktoren

EventDescriptor(MemberDescriptor)	Initialisiert eine neue Instanz der EventDescriptor-Klasse mit dem Namen und den Attributen im angegebenen MemberDescriptor.
EventDescriptor(MemberDescriptor, Attribute[])	Initialisiert eine neue Instanz der EventDescriptor-Klasse mit dem Namen im angegebenen MemberDescriptor und den Attributen im MemberDescriptor sowie dem Attribute-Array.
EventDescriptor(String, Attribute[])	Initialisiert eine neue Instanz der EventDescriptor-Klasse mit dem angegebenen Namen und Attributarray.

Eigenschaften

AttributeArray	Ruft ein Array von Attributen ab oder legt es fest. (Geerbt von MemberDescriptor)
Attributes	Ruft die Auflistung von Attributen für diesen Member ab. (Geerbt von MemberDescriptor)
Category	Ruft den Namen der Kategorie ab, zu der der Member gehört. Dieser ist in der CategoryAttribute-Klasse angegeben. (Geerbt von MemberDescriptor)
ComponentType	Ruft beim Überschreiben in einer abgeleiteten Klasse den Typ der Komponente ab, an die dieses Ereignis gebunden ist.
Description	Ruft die Beschreibung des Members ab, die in der DescriptionAttribute-Klasse angegeben ist. (Geerbt von MemberDescriptor)
DesignTimeOnly	Ruft ab, ob dieser Member nur zur Entwurfszeit festgelegt werden darf. Dies ist in der DesignOnlyAttribute-Klasse angegeben. (Geerbt von MemberDescriptor)
DisplayName	Ruft den Namen ab, der in einem Fenster, z. B. im Eigenschaftenfenster, angezeigt werden kann. (Geerbt von MemberDescriptor)
EventType	Ruft beim Überschreiben in einer abgeleiteten Klasse den Typ des Delegaten für das Ereignis ab.
IsBrowsable	Ruft einen Wert ab, der angibt, ob der Member durchsucht werden kann. Dies ist in der BrowsableAttribute-Klasse angegeben. (Geerbt von MemberDescriptor)
IsMulticast	Ruft beim Überschreiben in einer abgeleiteten Klasse einen Wert ab, der angibt, ob der Ereignisdelegat ein Multicastdelegat ist.
Name	Ruft den Namen des Members ab. (Geerbt von MemberDescriptor)
NameHashCode	Ruft den Hashcode für den Namen des Members ab, der in GetHashCode() angegeben ist. (Geerbt von MemberDescriptor)

Methoden

AddEventHandler(Object, Delegate)	Bindet beim Überschreiben in einer abgeleiteten Klasse das Ereignis an die Komponente.
CreateAttributeCollection()	Erstellt eine Auflistung von Attributen, wobei das Array von Attributen verwendet wird, das an den Konstruktor übergeben wurde. (Geerbt von MemberDescriptor)
Equals(Object)	Vergleicht diese Instanz und das angegebene Objekt auf Äquivalenz. (Geerbt von MemberDescriptor)
FillAttributes(IList)	Fügt beim Überschreiben in einer abgeleiteten Klasse der angegebenen Attributliste in der übergeordneten Klasse die Attribute der erbenden Klasse hinzu. (Geerbt von MemberDescriptor)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von MemberDescriptor)
GetInvocationTarget(Type, Object)	Ruft das Objekt ab, das beim Aufrufen der Member verwendet werden soll. (Geerbt von MemberDescriptor)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
RemoveEventHandler(Object, Delegate)	Hebt beim Überschreiben in einer abgeleiteten Klasse die Bindung des Delegaten mit der Komponente auf, sodass der Delegat keine weiteren Ereignisse von der Komponente empfängt.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• MemberDescriptor
• Attribute