EventDescriptor Classe

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.dll

Fournit des informations sur un événement.

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

Héritage

Object

MemberDescriptor

EventDescriptor

Attributs

ComVisibleAttribute

Exemples

L’exemple de code suivant est basé sur l’exemple dans la EventDescriptorCollection classe. Il imprime les informations (catégorie, description et nom complet) de chaque événement sur un bouton d’une zone de texte. Elle exige qu’elle button1 ait textbox1 été instanciée sur un formulaire.

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

Remarques

Il EventDescriptor se compose d’un nom, de ses attributs, du composant auquel l’événement est lié, du délégué d’événement, du type de délégué et de la multidiffusion du délégué.

EventDescriptor fournit les propriétés et méthodes suivantes abstract :

• ComponentType contient le type du composant sur lequel cet événement est déclaré.

• EventType contient le type de délégué pour l’événement.

• IsMulticast contient une valeur indiquant si le délégué d’événement est un délégué multidiffusion.

• AddEventHandler lie l’événement à un composant.

• RemoveEventHandler dissocie le délégué du composant afin que le délégué ne reçoive plus d’événements du composant.

Pour plus d’informations sur les événements, consultez Gestion et déclenchement d’événements. Pour plus d’informations sur la réflexion, consultez les rubriques de réflexion.

Constructeurs

Nom	Description
EventDescriptor(MemberDescriptor, Attribute[])	Initialise une nouvelle instance de la EventDescriptor classe avec le nom dans les attributs spécifiés MemberDescriptor et dans le MemberDescriptorAttribute tableau.
EventDescriptor(MemberDescriptor)	Initialise une nouvelle instance de la EventDescriptor classe avec le nom et les attributs dans le fichier spécifié MemberDescriptor.
EventDescriptor(String, Attribute[])	Initialise une nouvelle instance de la classe avec le nom et le EventDescriptor tableau d’attributs spécifiés.

Propriétés

Nom	Description
AttributeArray	Obtient ou définit un tableau d’attributs. (Hérité de MemberDescriptor)
Attributes	Obtient la collection d’attributs pour ce membre. (Hérité de MemberDescriptor)
Category	Obtient le nom de la catégorie à laquelle appartient le membre, comme spécifié dans le CategoryAttribute. (Hérité de MemberDescriptor)
ComponentType	En cas de substitution dans une classe dérivée, obtient le type de composant auquel cet événement est lié.
Description	Obtient la description du membre, comme spécifié dans le DescriptionAttribute. (Hérité de MemberDescriptor)
DesignTimeOnly	Obtient si ce membre doit être défini uniquement au moment du design, comme spécifié dans le DesignOnlyAttribute. (Hérité de MemberDescriptor)
DisplayName	Obtient le nom qui peut être affiché dans une fenêtre, telle qu’une fenêtre Propriétés. (Hérité de MemberDescriptor)
EventType	En cas de substitution dans une classe dérivée, obtient le type de délégué pour l’événement.
IsBrowsable	Obtient une valeur indiquant si le membre est pouvant faire l’objet d’une croissance, comme spécifié dans le BrowsableAttribute. (Hérité de MemberDescriptor)
IsMulticast	En cas de substitution dans une classe dérivée, obtient une valeur indiquant si le délégué d’événement est un délégué multidiffusion.
Name	Obtient le nom du membre. (Hérité de MemberDescriptor)
NameHashCode	Obtient le code de hachage pour le nom du membre, comme spécifié dans GetHashCode(). (Hérité de MemberDescriptor)

Méthodes

Nom	Description
AddEventHandler(Object, Delegate)	En cas de substitution dans une classe dérivée, lie l’événement au composant.
CreateAttributeCollection()	Crée une collection d’attributs à l’aide du tableau d’attributs transmis au constructeur. (Hérité de MemberDescriptor)
Equals(Object)	Compare cette instance à l’objet donné pour voir s’ils sont équivalents. (Hérité de MemberDescriptor)
FillAttributes(IList)	En cas de substitution dans une classe dérivée, ajoute les attributs de la classe héritée à la liste spécifiée d’attributs dans la classe parente. (Hérité de MemberDescriptor)
GetHashCode()	Retourne le code de hachage pour cette instance. (Hérité de MemberDescriptor)
GetInvocationTarget(Type, Object)	Récupère l’objet qui doit être utilisé pendant l’appel des membres. (Hérité de MemberDescriptor)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
RemoveEventHandler(Object, Delegate)	En cas de substitution dans une classe dérivée, annule la liaison du délégué du composant afin que le délégué ne reçoive plus d’événements du composant.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• MemberDescriptor
• Attribute