Exporter (0) Imprimer
Développer tout

EventDescriptor, classe

Mise à jour : novembre 2007

Fournit des informations sur un événement.

Espace de noms :  System.ComponentModel
Assembly :  System (dans System.dll)

[ComVisibleAttribute(true)]
[HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true)]
public abstract class EventDescriptor : MemberDescriptor
/** @attribute ComVisibleAttribute(true) */
/** @attribute HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true) */
public abstract class EventDescriptor extends MemberDescriptor
public abstract class EventDescriptor extends MemberDescriptor

Remarque :

L'attribut HostProtectionAttribute appliqué à ce type ou membre a la valeur de propriété Resources suivante : SharedState. HostProtectionAttribute n'affecte pas les applications bureautiques (qui sont généralement démarrées en double-cliquant sur une icône, en tapant une commande ou en entrant une URL dans un navigateur). Pour plus d'informations, consultez la classe HostProtectionAttribute ou Attributs de programmation et de protection des hôtes SQL Server.

Un EventDescriptor comprend un nom, ses attributs, le composant auquel l'événement est lié, le délégué d'événement, le type de délégué et une valeur indiquant s'il s'agit d'un délégué multicast.

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

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

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

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

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

  • RemoveEventHandler supprime la liaison du délégué avec le composant de sorte que le délégué ne reçoit plus les événements du composant.

Pour plus d'informations sur les événements, consultez Déclenchement d'un événement. Pour plus d'informations sur la réflexion, consultez les rubriques proposées dans Réflexion.

L'exemple de code suivant s'appuie sur l'exemple fourni dans la classe EventDescriptorCollection. Il imprime les informations (catégorie, description et nom complet) de chaque événement sur un bouton d'une zone de texte. Il requiert que button1 et textbox1 aient été instanciés dans un formulaire.

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


EventDescriptorCollection events = TypeDescriptor.GetEvents(button1);
System.ComponentModel.EventDescriptor myEvent = null;
// Displays each event's information in the collection in a text box.
for (int iCtr=0; iCtr < events.get_Count(); iCtr++) {
    myEvent = events.get_Item(iCtr);
    textBox1.set_Text(textBox1.get_Text() + myEvent.get_Category()
        + '\n');
    textBox1.set_Text(textBox1.get_Text() + myEvent.get_Description() 
        + '\n');
    textBox1.set_Text(textBox1.get_Text() + myEvent.get_DisplayName()
        + '\n');
}


Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC, Xbox 360

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Pris en charge dans : 3.5, 2.0, 1.0

XNA Framework

Pris en charge dans : 2.0, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft