Consommation d'événements

Pour consommer un événement dans une application, vous devez fournir un gestionnaire d'événements (une méthode de gestion d'événements) qui exécute la logique de programme en réponse à l'événement et inscrit le gestionnaire d'événements dans la source de l'événement. Ce processus est appelé connexion des événements. Les concepteurs visuels Windows Forms et Web Forms proposent des outils RAD (Rapid Application Development) qui simplifient ou masquent les détails de la connexion des événements.

Cette rubrique décrit le modèle général de la gestion d'événements. Pour obtenir une vue d'ensemble du modèle d'événement dans le .NET Framework, consultez Événements et délégués. Pour plus d'informations sur le modèle d'événement dans les Windows Forms, consultez Comment : consommer des événements dans une application Windows Forms. Pour plus d'informations sur le modèle d'événement dans Web Forms, consultez Comment : consommer des événements dans une application Web Forms.

Modèle d'événement

Les détails de la connexion des événements diffèrent dans les Windows Forms et dans Web Forms en raison des différents niveaux de prise en charge fournis par divers outils RAD. Toutefois, les deux scénarios suivent le même modèle d'événement qui possède les caractéristiques suivantes :

• Une classe qui déclenche un événement nommé EventName possède le membre suivant :

  public event EventNameEventHandler EventName;
  

  Public Event EventName As EventNameEventHandler
  

• Le délégué d'événement de l'événement EventName est EventNameEventHandler, avec la signature suivante :

  public delegate void EventNameEventHandler(object sender, EventNameEventArgs e);
  

  Public Delegate Sub EventNameEventHandler(sender As Object, e As EventNameEventArgs)
  

Pour utiliser l'événement EventName, votre gestionnaire d'événements doit posséder la même signature que celle du délégué d'événement :

void EventHandler(object sender, EventNameEventArgs e) {}

Sub EventHandler(sender As Object, e As EventNameEventArgs)

Lorsqu'un événement n'a pas de données associées, la classe qui déclenche l'événement utilise System.EventHandler comme délégué et System.EventArgs pour les données d'événement. Les événements qui possèdent des données associées utilisent des classes qui dérivent d'EventArgs à partir du type de données d'événement et le type délégué d'événement correspondant. Par exemple, si vous souhaitez gérer un événement MouseUp dans une application Windows Forms, la classe des données d'événement est MouseEventArgs et le délégué d'événement est MouseEventHandler. Notez que plusieurs événements de souris utilisent une classe commune pour les données d'événement et un délégué d'événement commun, si bien que le schéma d'affectation de noms ne correspond pas exactement à la convention décrite ci-dessus. Pour les événements de souris, votre gestionnaire d'événements doit posséder la signature suivante :

void Mouse_Moved(object sender, MouseEventArgs e){}

Sub Mouse_Moved(sender As Object, e As MouseEventArgs)

Les paramètres d'expéditeur et d'argument d'événement fournissent des détails supplémentaires à propos de l'événement de souris au gestionnaire d'événements. L'objet sender indique ce qui a déclenché l'événement. Le paramètre MouseEventArgs fournit des détails sur le déplacement de la souris qui a déclenché l'événement. Beaucoup de sources d'événements fournissent des données supplémentaires pour l'événement, et beaucoup de gestionnaires d'événements utilisent les données spécifiques à l'événement pour traiter l'événement. Pour obtenir un exemple qui illustre le déclenchement et la gestion des événements avec les données spécifiques à l'événement, consultez Comment : déclencher et utiliser des événements.

Pour plus d'informations sur le déclenchement d'événements à partir d'une classe, consultez Déclenchement d'un événement.

Voir aussi

Tâches

Comment : consommer des événements dans une application Web Forms
Comment : consommer des événements dans une application Windows Forms

Concepts

Événements et délégués
Déclenchement d'un événement

Autres ressources

Gestion et déclenchement d'événements