Bloc de construction : Gestion des événements
Dernière modification : mercredi 7 avril 2010
S’applique à : SharePoint Foundation 2010
Les objets principaux du modèle objet SharePoint Foundation fournissent des classes de base de récepteur d’événements à partir desquelles des dérivations peuvent être effectuées lors de l’écriture de gestionnaires d’événements. Par exemple, l’objet SPWeb a un type correspondant SPWebEventReceiver, l’objet SPList a un type SPListEventReceiver, etc. Vous n’implémentez pas directement les types des récepteurs d’événements ; au lieu de cela, vous devez hériter de la classe de récepteurs appropriée et implémenter la classe dérivée. Notez que toutes les classes de récepteurs d’événements héritent d’une même classe de base de récepteurs d’événements, qui est SPEventReceiverBase.
Après qu’ils ont été écrits, les récepteurs d’événements pour SharePoint Foundation sont compilés dans des assemblys de récepteurs d’événements et déployés vers le Global Assembly Cache. Les récepteurs d’événements doivent aussi être inscrits auprès de l’étendue pour laquelle ils gèrent des événements.
Modèle objet pour les événements
Il n’existe pas d’espace de noms de gestionnaire d’événements où se trouvent les types de gestionnaires d’événements. Au lieu de cela, les gestionnaires d’événements se trouvent dans le même espace de noms que les objets SharePoint qui leur sont associés. Par exemple, tous les objets SharePoint de plus haut niveau (SPWeb, SPSite, SPList, etc.) se trouvent dans l’espace de noms Microsoft.SharePoint avec les types de récepteurs d’événements qui leur sont associés. Notez que la convention de nommage pour les types de récepteurs d’événements suit le modèle courant décrit plus haut, c’est-à-dire <nom d’objet> avec le terme « EventReceiver » ajouté en tant que suffixe. De cette façon, les types de récepteurs d’événements tels que SPWorkflowEventReceiver et StyleLibraryEventReceiver sont faciles à identifier et à comprendre.
.gif "Note Attention") Attention |
|---|
Il existe quelques exceptions à la règle de nommage des récepteurs d’événements. Par exemple, le récepteur d’événements pour les fonctionnalités SharePoint est nommé SPFeatureReceiver, et non pas SPFeatureEventReceiver comme on pouvait s’y attendre. |
Les types de récepteurs d’événements sont également associés à des conteneurs de propriétés d’événements qui fournissent un accès à différentes propriétés d’un événement spécifié. Les conteneurs de propriétés d’événements sont généralement appelés <nom d’objet> avec le terme « EventProperties » ajouté en tant que suffixe. SPWebEventProperties et SPListEventProperties sont des exemples de conteneurs de propriétés de récepteurs d’événements.