EventInfo, classe

Utilisez la classe EventInfo pour examiner des événements et pour raccorder des gestionnaires d'événements, comme le montre l'exemple de code pour la méthode AddEventHandler.

Remarque
EventInfo n'est pas destiné à être utilisé pour déclencher des événements. L'état interne d'un objet détermine si celui-ci déclenche des événements.

Les événements sont utilisés avec des délégués. Un écouteur d'événements crée une instance d'un délégué de gestionnaire d'événements qui est appelé chaque fois qu'une source d'événements déclenche l'événement. Pour se connecter à la source d'événements, l'écouteur d'événements ajoute ce délégué à la liste des appels sur la source. Lorsque l'événement est déclenché, la méthode Invoke du délégué de gestionnaire d'événements est appelée. Les notifications d'événements à cast unique et multicast sont toutes deux prises en charge. Les méthodes Add et Remove, de même que la classe déléguée de gestionnaire d'événements associée à un événement, doivent être marquées dans les métadonnées.

Les délégués sont des pointeurs fonction orientés objet. Dans C ou C++, un pointeur fonction représente une référence à une méthode. Contrairement au pointeur fonction C ou C++, un délégué contient deux références : une référence à une méthode et une référence à un objet prenant en charge cette méthode. Les délégués peuvent appeler une méthode sans connaître le type classe qui déclare ou hérite la méthode. Il leur suffit de connaître le type de retour et la liste de paramètres de la méthode.

Le modèle d'événement fonctionne à la fois avec les délégués à cast unique et avec les délégués multicast. Lors de l'appel à la méthode Invoke du délégué, une méthode est appelée sur un objet unique. Un modificateur multicast peut être appliqué à la déclaration delegate. Il est alors possible d'appeler plusieurs méthodes lors de l'appel à la méthode Invoke du délégué.

L'appel à la méthode ICustomAttributeProvider.GetCustomAttributes sur EventInfo lorsque le paramètre inherit de GetCustomAttributes est true n'effectue pas de recherche dans la hiérarchie des types. Utilisez System.Attribute pour hériter des attributs personnalisés.

Lorsque vous héritez de EventInfo, vous devez substituer les membres suivants : GetAddMethod, GetRemoveMethod et GetRaiseMethod.

Le code suivant obtient un objet EventInfo pour l'événement Click de la classe Button.

using System;
using System.Reflection;
using System.Security;

class MyEventExample
{
    public static void Main()
    {  
        try
        {

            // Creates a bitmask based on BindingFlags.
            BindingFlags myBindingFlags = BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic;
            Type myTypeBindingFlags = typeof(System.Windows.Forms.Button);
            EventInfo myEventBindingFlags = myTypeBindingFlags.GetEvent("Click", myBindingFlags);
            if(myEventBindingFlags != null)
            {
                Console.WriteLine("Looking for the Click event in the Button class with the specified BindingFlags.");
                Console.WriteLine(myEventBindingFlags.ToString());
            }
            else
                Console.WriteLine("The Click event is not available with the Button class.");
        }
        catch(SecurityException e)
        {
            Console.WriteLine("An exception occurred.");
            Console.WriteLine("Message :"+e.Message);
        }
        catch(ArgumentNullException e)
        {
            Console.WriteLine("An exception occurred.");
            Console.WriteLine("Message :"+e.Message);
        }
        catch(Exception e)
        {
            Console.WriteLine("The following exception was raised : {0}",e.Message);
        }
    }
}

.NET Framework

.NET Framework Client Profile

• SecurityAction.InheritanceDemand  

  pour une confiance totale accordée aux héritiers. Cette classe ne peut pas être héritée par du code d'un niveau de confiance partiel.

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Ce type est thread-safe.

Référence