Nouveaux événements dans SharePoint Foundation 2010
Dernière modification : jeudi 8 avril 2010
S’applique à : SharePoint Foundation 2010
Dans cet article
Nouveaux événements Ajout et Suppression sur des listes
Nouveaux événements Ajout sur des sites SharePoint
Nouveaux événements synchrones Après
Pour permettre de meilleures performances et une plus grande souplesse, de nouveaux événements ont été ajoutés à la plateforme de développement de Microsoft SharePoint Foundation 2010. Pour consulter le catalogue de l’ensemble des événements disponibles dans SharePoint Foundation incluant des notations pour repérer ces nouveaux événements de SharePoint Foundation 2010, voir Catalogue des événements SharePoint Foundation.
Nouveaux événements Ajout et Suppression sur des listes
Deux nouveaux événements Add sont fournis pour les listes SharePoint, c’est-à-dire pour les objets SPList :
Les événements Add prennent les propriétés rendues disponibles à l’aide de SPListEventProperties et sont générés à la création d’une nouvelle liste.
L’événement ListAdding permet d’annuler la création de la liste. Notez, cependant, que cette annulation est déconseillée lorsque vous mettez en service une définition ou un modèle de site. Notez également que des événements ListAdding sont générés lorsque vous restaurez un site à l’aide des API de l’espace de noms Microsoft.SharePoint.Deployment.
Lorsque vous déployez une solution, vous pouvez maintenant définir des options qui permettent de ne pas tenir compte des événements qui se produisent au cours du déploiement. L’événement ListAdding se produit également lorsqu’une liste est restaurée après son recyclage. Ce comportement est cohérent avec le fonctionnement habituel des listes SharePoint. SPListEventProperties comporte deux propriétés supplémentaires, TemplateId et FeatureId, qui sont passées en tant que paramètres afin que le développeur qui utilise un événement ListAdding puisse déterminer le type de liste créé.
Outre ces événements Add, deux événements Delete ont aussi été ajoutés aux listes SharePoint :
Ces événements Delete vous permettent d’annuler une opération de suppression de liste en tout point de l’opération. Lorsque vous annulez une opération de suppression, un message d’erreur est renvoyé via l’interface et une exception est générée. Notez que des événements Delete se produisent également au recyclage d’une liste (même si la liste n’est pas elle-même supprimée d’un point de vue technique). Ce comportement est cohérent avec le fonctionnement habituel des éléments de liste SharePoint.
Il n’y a pas génération d’événements Delete sur des objets de portée plus étroite lorsque des objets de niveau supérieur sont supprimés. Par exemple, si un événement Delete se produit au niveau du site Web, les événements de portée plus étroite (par exemple, sur des événements de liste particuliers) ne sont pas générés. C’est la raison pour laquelle il est important de ne pas perdre de vue la portée des événements lors du codage des événements de suppression. Notez, également, que si quelqu’un supprime un dossier de liste autonome (par exemple, le dossier Lists à l’intérieur d’un site Web), il n’y a aucun événement récupérable et aucune génération d’événements de liste.
Nouveaux événements Ajout sur des sites SharePoint
D’autres événements nouveaux offrent davantage de contrôle et de souplesse lors de la création d’un site SharePoint (une instance SPWeb). Notez, cependant, que la création d’un site SharePoint comprend deux étapes distinctes. D’abord, vous ajoutez un site à la collection de sites (vous créez une instance SPSite). À ce stade, le site lui-même représente à peine plus qu’un dossier vide et qu’un ensemble de propriétés. Ensuite, vous mettez en service le site (c’est-à-dire, vous appliquez un modèle Web). Ensuite, des éléments tels que listes, fichiers et d’autres objets de contenu sont instanciés et organisés en fonction de la définition de site spécifiée.
Comme la plupart de l’activité importante se produit pendant la phase de mise en service, ces nouveaux événements liés au site sont associés au processus d’ajout et de mise en service du site :
L’événement WebAdding est déclenché avant la création d’un nouveau site Web, donc si l’opération de création est annulée, aucun site SharePoint n’est créé et le processus de mise en service ne démarre pas. Vous pouvez utiliser l’événement WebAdding pour effectuer des activités comme la validation conditionnelle, qui permet de garantir que l’URL est valide, par exemple, ou que l’utilisateur qui crée un site dispose des informations d’identification appropriées.
L’événement WebProvisioned se produit une fois le site Web totalement configuré et que le processus de mise en service est terminé. Cet événement peut être configuré pour fonctionner en mode soit synchrone, soit asynchrone. Utilisez-le pour mettre au point des opérations de développement, par exemple pour ajouter des composants WebPart au site.
Nouveaux événements synchrones Après
Les événements after synchrones sont conçus pour répondre à des besoins seulement partiellement remplis par les événements asynchrones – en l’occurrence, la possibilité d’agir sur un élément de liste après sa soumission à la base de données de contenu, mais avant que l’utilisateur ne voit effectivement cet élément de liste. Lorsque des événements after synchrones se produisent, ils sont traités avant que le gestionnaire d’événements abandonne le contrôle.
Notes
Le comportement de synchronisation par défaut est synchrone pour les événements before et asynchrone pour les événements after.
Une nouvelle propriété est également disponible sur la classe de base SPEventReceiverDefinition appelée Synchronization. Cette propriété dispose des méthodes get et set pour définir et récupérer la valeur d’énumération SPEventReceiverSynchronization. Cette énumération fournit une valeur appelée Default pour prendre en charge la rétrocompatibilité.
Voir aussi
Concepts
Améliorations du modèle d’événements pour SharePoint Foundation 2010