Comment : gérer plusieurs événements à l'aide des propriétés d'événements
Mise à jour : novembre 2007
Pour utiliser des propriétés d'événements (événements personnalisés dans Visual Basic 2005), vous définissez les propriétés d'événements dans la classe qui déclenche les événements, puis affectez les délégués pour les propriétés d'événements dans les classes qui gèrent les événements. Pour implémenter plusieurs propriétés d'événements dans une classe, la classe doit stocker et maintenir le délégué défini pour chaque événement en interne. Une approche courante consiste à implémenter une collection de délégués indexée par une clé d'événement.
Pour stocker les délégués pour chaque événement, vous pouvez utiliser la classe EventHandlerList ou implémenter votre propre collection. La classe de collection doit fournir des méthodes pour le paramétrage, l'accès et la récupération du délégué de gestionnaire d'événements selon la clé d'événement. Par exemple, vous pourriez utiliser une classe Hashtable ou dériver une classe personnalisée de la classe DictionaryBase. Les détails de l'implémentation de la collection de délégués ne doivent pas être exposés à l'extérieur de votre classe.
Chaque propriété d'événement dans la classe définit une méthode d'accesseur add et une méthode d'accesseur remove. L'accesseur add pour une propriété d'événement ajoute l'instance de délégué d'entrée à la collection de délégués. L'accesseur remove pour une propriété d'événement supprime l'instance de délégué d'entrée de la collection de délégués. Les accesseurs de propriété d'événement utilisent la clé prédéfinie pour la propriété d'événement pour ajouter et supprimer des instances de la collection de délégués.
Pour gérer plusieurs événements à l'aide de propriétés d'événements
Définissez une collection de délégués dans la classe qui déclenche les événements.
Définissez une clé pour chaque événement.
Définissez les propriétés d'événements dans la classe qui déclenche les événements.
Utilisez la collection de délégués pour implémenter les méthodes d'accesseur add et remove pour les propriétés d'événements.
Utilisez les propriétés d'événements publiques pour ajouter et supprimer des délégués de gestionnaire d'événements dans les classes qui gèrent les événements.
Exemple
L'exemple C# suivant implémente les propriétés d'événements MouseDown et MouseUp, à l'aide d'un EventHandlerList pour stocker le délégué de chaque événement. Les mots clés des constructions des propriétés d'événements sont en gras.
.gif "Remarque") Remarque : |
|---|
Les propriétés d'événements ne sont pas prises en charge dans Visual Basic 2005. |
// The class SampleControl defines two event properties, MouseUp and MouseDown.
class SampleControl: Component {
// :
// Define other control methods and properties.
// :
// Define the delegate collection.
protected EventHandlerList listEventDelegates = new EventHandlerList();
// Define a unique key for each event.
static readonly object mouseDownEventKey = new object();
static readonly object mouseUpEventKey = new object();
// Define the MouseDown event property.
public event MouseEventHandler MouseDown {
// Add the input delegate to the collection.
add { listEventDelegates.AddHandler(mouseDownEventKey, value); }
// Remove the input delegate from the collection.
remove { listEventDelegates.RemoveHandler(mouseDownEventKey, value); }
}
// Define the MouseUp event property.
public event MouseEventHandler MouseUp {
// Add the input delegate to the collection.
add { listEventDelegates.AddHandler(mouseUpEventKey, value); }
// Remove the input delegate from the collection.
remove { listEventDelegates.RemoveHandler(mouseUpEventKey, value); }
}
}
Voir aussi
Tâches
Comment : déclarer des événements qui économisent l'utilisation de la mémoire
Concepts
Déclenchement de plusieurs événements
Référence
System.ComponentModel.EventHandlerList