EventDescriptor Classe

Definizione

Include informazioni su un evento.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
Ereditarietà
EventDescriptor
Attributi

Esempi

L'esempio di codice seguente si basa sull'esempio nella EventDescriptorCollection classe.The following code example is built upon the example in the EventDescriptorCollection class. Stampa le informazioni (categoria, descrizione e nome visualizzato) di ogni evento su un pulsante in una casella di testo.It prints the information (category, description, and display name) of each event on a button in a text box. Richiede che sia button1 stata textbox1 creata un'istanza di e che sia stata creata un'istanza in un form.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

Commenti

Un EventDescriptor oggetto è costituito da un nome, dagli attributi, dal componente a cui è associato l'evento, dal delegato dell'evento, dal tipo di delegato e dal fatto che il delegato sia multicast.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.

EventDescriptorfornisce le proprietà abstract e i metodi seguenti:EventDescriptor provides the following abstract properties and methods:

  • ComponentTypecontiene il tipo del componente in cui è dichiarato questo evento.ComponentType contains the type of the component this event is declared on.

  • EventTypecontiene il tipo di delegato per l'evento.EventType contains the type of delegate for the event.

  • IsMulticastcontiene un valore che indica se il delegato dell'evento è un delegato multicast.IsMulticast contains a value indicating whether the event delegate is a multicast delegate.

  • AddEventHandlerassocia l'evento a un componente.AddEventHandler binds the event to a component.

  • RemoveEventHandlerAnnulla l'associazione tra il delegato e il componente, in modo che il delegato non riceva più eventi dal componente.RemoveEventHandler unbinds the delegate from the component so that the delegate no longer receives events from the component.

Per ulteriori informazioni sugli eventi, vedere gestione e generazione di eventi.For more information about events, see Handling and Raising Events. Per ulteriori informazioni sulla reflection, vedere gli argomenti in Reflection.For more information about reflection, see the topics in Reflection.

Costruttori

EventDescriptor(MemberDescriptor)

Inizializza una nuova istanza della classe EventDescriptor con il nome e gli attributi nell'oggetto MemberDescriptor specificato.Initializes a new instance of the EventDescriptor class with the name and attributes in the specified MemberDescriptor.

EventDescriptor(MemberDescriptor, Attribute[])

Inizializza una nuova istanza della classe EventDescriptor con il nome nell'oggetto MemberDescriptor specificato e gli attributi nell'oggetto MemberDescriptor e nella matrice Attribute.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[])

Consente di inizializzare una nuova istanza della classe EventDescriptor con il nome specificato e la matrice degli attributi.Initializes a new instance of the EventDescriptor class with the specified name and attribute array.

Proprietà

AttributeArray

Ottiene o imposta una matrice di attributi.Gets or sets an array of attributes.

(Ereditato da MemberDescriptor)
Attributes

Ottiene l'insieme di attributi per questo membro.Gets the collection of attributes for this member.

(Ereditato da MemberDescriptor)
Category

Ottiene il nome della categoria alla quale appartiene il membro, come specificato in CategoryAttribute.Gets the name of the category to which the member belongs, as specified in the CategoryAttribute.

(Ereditato da MemberDescriptor)
ComponentType

Quando è sottoposto a override in una classe derivata, consente di ottenere il tipo di componente a cui l'evento è associato.When overridden in a derived class, gets the type of component this event is bound to.

Description

Ottiene la descrizione del membro, come specificato in DescriptionAttribute.Gets the description of the member, as specified in the DescriptionAttribute.

(Ereditato da MemberDescriptor)
DesignTimeOnly

Indica se questo membro deve essere impostato soltanto in fase di progettazione, come specificato in DesignOnlyAttribute.Gets whether this member should be set only at design time, as specified in the DesignOnlyAttribute.

(Ereditato da MemberDescriptor)
DisplayName

Ottiene il nome che può essere visualizzato in una finestra, quale una finestra delle proprietà.Gets the name that can be displayed in a window, such as a Properties window.

(Ereditato da MemberDescriptor)
EventType

Quando è sottoposto a override in una classe derivata, consente di ottenere il tipo di delegato dell'evento.When overridden in a derived class, gets the type of delegate for the event.

IsBrowsable

Ottiene un valore che indica se il membro è esplorabile, come specificato in BrowsableAttribute.Gets a value indicating whether the member is browsable, as specified in the BrowsableAttribute.

(Ereditato da MemberDescriptor)
IsMulticast

Quando è sottoposto a override in una classe derivata, consente di ottenere un valore che indica se il delegato dell'evento è di tipo multicast.When overridden in a derived class, gets a value indicating whether the event delegate is a multicast delegate.

Name

Ottiene il nome del membro.Gets the name of the member.

(Ereditato da MemberDescriptor)
NameHashCode

Ottiene il codice hash per il nome del membro, come specificato nel metodo GetHashCode().Gets the hash code for the name of the member, as specified in GetHashCode().

(Ereditato da MemberDescriptor)

Metodi

AddEventHandler(Object, Delegate)

Quando è sottoposto a override in una classe derivata, consente di associare l'evento al componente.When overridden in a derived class, binds the event to the component.

CreateAttributeCollection()

Consente di creare un insieme di attributi utilizzando la matrice di attributi passati al costruttore.Creates a collection of attributes using the array of attributes passed to the constructor.

(Ereditato da MemberDescriptor)
Equals(Object)

Consente di confrontare questa istanza con l'oggetto specificato per verificare se sono equivalenti.Compares this instance to the given object to see if they are equivalent.

(Ereditato da MemberDescriptor)
FillAttributes(IList)

Quando è sottoposto a override in una classe derivata, consente di aggiungere gli attributi della classe che eredita all'elenco specificato di attributi nella classe padre.When overridden in a derived class, adds the attributes of the inheriting class to the specified list of attributes in the parent class.

(Ereditato da MemberDescriptor)
GetHashCode()

Restituisce il codice hash per l'istanza.Returns the hash code for this instance.

(Ereditato da MemberDescriptor)
GetInvocationTarget(Type, Object)

Recupera l'oggetto da utilizzare durante la chiamata dei membri.Retrieves the object that should be used during invocation of members.

(Ereditato da MemberDescriptor)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
RemoveEventHandler(Object, Delegate)

Quando è sottoposto a override in una classe derivata, consente di separare il delegato dal componente in modo che il delegato non riceva più eventi dal componente.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()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche