EventDescriptor Klasse

Definition

Enthält Informationen über ein Ereignis.Provides information about an event.

public ref class EventDescriptor abstract : System::ComponentModel::MemberDescriptor
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class EventDescriptor : System.ComponentModel.MemberDescriptor
type EventDescriptor = class
    inherit MemberDescriptor
Public MustInherit Class EventDescriptor
Inherits MemberDescriptor
Vererbung
EventDescriptor
Attribute

Beispiele

Das folgende Codebeispiel basiert auf dem Beispiel in der EventDescriptorCollection -Klasse.The following code example is built upon the example in the EventDescriptorCollection class. Sie gibt die Informationen (Kategorie, Beschreibung und Anzeige Name) jedes Ereignisses auf einer Schaltfläche in einem Textfeld aus.It prints the information (category, description, and display name) of each event on a button in a text box. Dies erfordert, button1 dass textbox1 und in einem Formular instanziiert wurden.It requires that button1 and textbox1 have been instantiated on a form.

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 Ereignis Delegaten, dem Typ des Delegaten und dem, ob der Delegat Multicast ist.An EventDescriptor consists of a name, its attributes, the component that the event is bound to, the event delegate, the type of delegate, and whether the delegate is multicast.

EventDescriptorstellt die folgenden abstract Eigenschaften und Methoden bereit:EventDescriptor provides the following abstract properties and methods:

  • ComponentTypeenthält den Typ der Komponente, für die dieses Ereignis deklariert ist.ComponentType contains the type of the component this event is declared on.

  • EventTypeenthält den Typ des Delegaten für das Ereignis.EventType contains the type of delegate for the event.

  • IsMulticastenthält einen Wert, der angibt, ob der Ereignis Delegat ein Multicast Delegat ist.IsMulticast contains a value indicating whether the event delegate is a multicast delegate.

  • AddEventHandlerbindet das Ereignis an eine Komponente.AddEventHandler binds the event to a component.

  • RemoveEventHandlerhebt die Bindung des Delegaten an die Komponente auf, sodass der Delegat nicht mehr Ereignisse von der Komponente empfängt.RemoveEventHandler unbinds the delegate from the component so that the delegate no longer receives events from the component.

Weitere Informationen zu Ereignissen finden Sie unter behandeln und Auswerfen von Ereignissen.For more information about events, see Handling and Raising Events. Weitere Informationen zur Reflektion finden Sie in den Themen unter Reflektion.For more information about reflection, see the topics in Reflection.

Konstruktoren

EventDescriptor(MemberDescriptor)

Initialisiert eine neue Instanz der EventDescriptor-Klasse mit dem Namen und den Attributen im angegebenen MemberDescriptor.Initializes a new instance of the EventDescriptor class with the name and attributes in the specified 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.Initializes a new instance of the EventDescriptor class with the name in the specified MemberDescriptor and the attributes in both the MemberDescriptor and the Attribute array.

EventDescriptor(String, Attribute[])

Initialisiert eine neue Instanz der EventDescriptor-Klasse mit dem angegebenen Namen und Attributarray.Initializes a new instance of the EventDescriptor class with the specified name and attribute array.

Eigenschaften

AttributeArray

Ruft ein Array von Attributen ab oder legt dieses fest.Gets or sets an array of attributes.

(Geerbt von MemberDescriptor)
Attributes

Ruft die Auflistung von Attributen für diesen Member ab.Gets the collection of attributes for this member.

(Geerbt von MemberDescriptor)
Category

Ruft den Namen der Kategorie ab, zu der der Member gehört. Dieser ist in der CategoryAttribute-Klasse angegeben.Gets the name of the category to which the member belongs, as specified in the CategoryAttribute.

(Geerbt von MemberDescriptor)
ComponentType

Ruft beim Überschreiben in einer abgeleiteten Klasse den Typ der Komponente ab, an die dieses Ereignis gebunden ist.When overridden in a derived class, gets the type of component this event is bound to.

Description

Ruft die Beschreibung des Members ab, die in der DescriptionAttribute-Klasse angegeben ist.Gets the description of the member, as specified in the DescriptionAttribute.

(Geerbt von MemberDescriptor)
DesignTimeOnly

Ruft ab, ob dieser Member nur zur Entwurfszeit festgelegt werden darf. Dies ist in der DesignOnlyAttribute-Klasse angegeben.Gets whether this member should be set only at design time, as specified in the DesignOnlyAttribute.

(Geerbt von MemberDescriptor)
DisplayName

Ruft den Namen ab, der in einem Fenster, z. B. im Eigenschaftenfenster, angezeigt werden kann.Gets the name that can be displayed in a window, such as a Properties window.

(Geerbt von MemberDescriptor)
EventType

Ruft beim Überschreiben in einer abgeleiteten Klasse den Typ des Delegaten für das Ereignis ab.When overridden in a derived class, gets the type of delegate for the event.

IsBrowsable

Ruft einen Wert ab, der angibt, ob der Member durchsucht werden kann. Dies ist in der BrowsableAttribute-Klasse angegeben.Gets a value indicating whether the member is browsable, as specified in the BrowsableAttribute.

(Geerbt von MemberDescriptor)
IsMulticast

Ruft beim Überschreiben in einer abgeleiteten Klasse einen Wert ab, der angibt, ob der Ereignisdelegat ein Multicastdelegat ist.When overridden in a derived class, gets a value indicating whether the event delegate is a multicast delegate.

Name

Ruft den Namen des Members ab.Gets the name of the member.

(Geerbt von MemberDescriptor)
NameHashCode

Ruft den Hashcode für den Namen des Members ab, der in GetHashCode() angegeben ist.Gets the hash code for the name of the member, as specified in GetHashCode().

(Geerbt von MemberDescriptor)

Methoden

AddEventHandler(Object, Delegate)

Bindet beim Überschreiben in einer abgeleiteten Klasse das Ereignis an die Komponente.When overridden in a derived class, binds the event to the component.

CreateAttributeCollection()

Erstellt eine Auflistung von Attributen, wobei das Array von Attributen verwendet wird, das an den Konstruktor übergeben wurde.Creates a collection of attributes using the array of attributes passed to the constructor.

(Geerbt von MemberDescriptor)
Equals(Object)

Vergleicht diese Instanz und das angegebene Objekt auf Äquivalenz.Compares this instance to the given object to see if they are equivalent.

(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.When overridden in a derived class, adds the attributes of the inheriting class to the specified list of attributes in the parent class.

(Geerbt von MemberDescriptor)
GetHashCode()

Gibt den Hashcode für diese Instanz zurück.Returns the hash code for this instance.

(Geerbt von MemberDescriptor)
GetInvocationTarget(Type, Object)

Ruft das Objekt ab, das beim Aufrufen der Member verwendet werden soll.Retrieves the object that should be used during invocation of members.

(Geerbt von MemberDescriptor)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current 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.When overridden in a derived class, unbinds the delegate from the component so that the delegate will no longer receive events from the component.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch