EventDescriptor Klasse

Definition

Namespace:

System.ComponentModel

Assembly:

System.dll

Stellt Informationen zu einem Ereignis bereit.

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

[System.Runtime.InteropServices.ComVisible(true)]
public abstract class EventDescriptor : System.ComponentModel.MemberDescriptor

[<System.Runtime.InteropServices.ComVisible(true)>]
type EventDescriptor = class
    inherit MemberDescriptor

Public MustInherit Class EventDescriptor
Inherits MemberDescriptor

Vererbung

Object

MemberDescriptor

EventDescriptor

Attribute

ComVisibleAttribute

Beispiele

Das folgende Codebeispiel basiert auf dem Beispiel in der EventDescriptorCollection Klasse. Sie druckt die Informationen (Kategorie, Beschreibung und Anzeigename) jedes Ereignisses auf einer Schaltfläche in einem Textfeld. Dies erfordert button1 und textbox1 wurde auf einem Formular instanziiert.

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 Stellvertretungstyp und dem Multicast des Delegaten.

EventDescriptor stellt die folgenden abstract Eigenschaften und Methoden bereit:

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

• 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 Verknüpfung des Delegaten aus der 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 Reflection.

Konstruktoren

Name	Beschreibung
EventDescriptor(MemberDescriptor, Attribute[])	Initialisiert eine neue Instanz der EventDescriptor Klasse mit dem Namen im angegebenen MemberDescriptor Und den Attributen sowohl im Array MemberDescriptor als auch Attribute im Array.
EventDescriptor(MemberDescriptor)	Initialisiert eine neue Instanz der EventDescriptor Klasse mit dem Namen und den Attributen im angegebenen MemberDescriptor.
EventDescriptor(String, Attribute[])	Initialisiert eine neue Instanz der EventDescriptor Klasse mit dem angegebenen Namen und Attributarray.

Eigenschaften

Name	Beschreibung
AttributeArray	Dient zum Abrufen oder Festlegen eines Arrays von Attributen. (Geerbt von MemberDescriptor)
Attributes	Ruft die Auflistung der Attribute für dieses Element ab. (Geerbt von MemberDescriptor)
Category	Ruft den Namen der Kategorie ab, zu der das Element gehört, wie in der CategoryAttribute. (Geerbt von MemberDescriptor)
ComponentType	Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft der Typ der Komponente ab, an die dieses Ereignis gebunden ist.
Description	Ruft die Beschreibung des Elements ab, wie in der DescriptionAttribute. (Geerbt von MemberDescriptor)
DesignTimeOnly	Ruft ab, ob dieses Element nur zur Entwurfszeit festgelegt werden soll, wie in der DesignOnlyAttribute. (Geerbt von MemberDescriptor)
DisplayName	Ruft den Namen ab, der in einem Fenster angezeigt werden kann, z. B. ein Eigenschaftenfenster. (Geerbt von MemberDescriptor)
EventType	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Stellvertretungstyp für das Ereignis ermittelt.
IsBrowsable	Ruft einen Wert ab, der angibt, ob das Element durchbrochen werden kann, wie in der BrowsableAttribute. (Geerbt von MemberDescriptor)
IsMulticast	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert abgerufen, der angibt, ob es sich bei dem Ereignisdelegat um einen Multicastdelegat handelt.
Name	Ruft den Namen des Elements ab. (Geerbt von MemberDescriptor)
NameHashCode	Ruft den Hashcode für den Namen des Elements ab, wie in GetHashCode(). (Geerbt von MemberDescriptor)

Methoden

Name	Beschreibung
AddEventHandler(Object, Delegate)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird das Ereignis an die Komponente gebunden.
CreateAttributeCollection()	Erstellt eine Auflistung von Attributen mithilfe des Arrays von Attributen, die an den Konstruktor übergeben werden. (Geerbt von MemberDescriptor)
Equals(Object)	Vergleicht diese Instanz mit dem angegebenen Objekt, um festzustellen, ob sie gleichwertig sind. (Geerbt von MemberDescriptor)
FillAttributes(IList)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, werden der angegebenen Liste der Attribute in der übergeordneten Klasse die Attribute der geerbten Klasse hinzugefügt. (Geerbt von MemberDescriptor)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von MemberDescriptor)
GetInvocationTarget(Type, Object)	Ruft das Objekt ab, das während des Aufrufs von Elementen verwendet werden soll. (Geerbt von MemberDescriptor)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
RemoveEventHandler(Object, Delegate)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Delegat von der Komponente getrennt, sodass der Delegat keine Ereignisse mehr von der Komponente empfängt.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• MemberDescriptor
• Attribute