Liaison de gestionnaires d’événements à l’aide de Composants fonctionnels SharePoint

Article
09/24/2014

Dernière modification : vendredi 9 avril 2010

S’applique à : SharePoint Foundation 2010

Vous pouvez définir des gestionnaires d’événements pour un type de contenu spécifique dans Microsoft SharePoint Foundation 2010 à l’aide d’un Composant fonctionnel SharePoint. Vous pouvez, par exemple, définir le type de contenu appelé « Client » et, dans la définition du comportement client, vous pouvez définir les métadonnées du gestionnaire d’événements associé.

Utilisation des Composants fonctionnels SharePoint

Vous définissez des types de contenu à l’aide d’un Composant fonctionnel SharePoint. Lorsque vous définissez un type de contenu avec une fonctionnalité, vous créez deux fichiers XML, décrits ci-après :

Feature.xml Vous utilisez ce fichier XML pour définir les métadonnées associées à la nouvelle fonctionnalité. L’exemple de code suivant définit l’étendue de la fonctionnalité au niveau du site et définit un identificateur unique pour la nouvelle fonctionnalité. À l’aide de l’élément ElementManifests, il pointe ensuite vers l’emplacement du second fichier XML qui stocke toutes les informations détaillées relatives à la fonctionnalité proprement dite.
```
<?xml version="1.0" encoding="utf-8"?>
<Feature Scope="Web" 
  Title="Simple Event Handler Registration" 
  Id="A6B8687A-3200-4b01-AD76-09E8D163FB9A" 
  xmlns="https://schemas.microsoft.com/sharepoint/">
  <ElementManifests>
    <ElementManifest Location="elements.xml"/>
  </ElementManifests>
</Feature>
```

Elements.xml Vous utilisez ce fichier pour définir l’assembly qui encapsule le gestionnaire d’événements, la classe proprement dite, ainsi qu’un numéro de séquence qui spécifie l’ordre si plusieurs gestionnaires d’événements sont associés au Composant fonctionnel. L’exemple suivant montre comment lier un récepteur d’événements qui réagit aux événements associés à la suppression et à l’ajout d’éléments de liste.

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <Receivers ListTemplateId="104">
    <Receiver>
      <Name>MyEventHandlers</Name>
      <Type>ItemDeleting</Type>
      <SequenceNumber>10000</SequenceNumber>
      <Assembly>MyEventHandlers, Version=1.0.0.0, Culture=neutral, PublicKeyToken=4358f2a5344ff0dc</Assembly>
      <Class>MyEventHandlers.SimpleEventHandler</Class>
      <Data></Data>
      <Filter></Filter>
    </Receiver>
    <Receiver>
      <Name>MyEventHandlers</Name>
      <Type>ItemAdded</Type>
      <SequenceNumber>10000</SequenceNumber>
      <Assembly>MyEventHandlers, Version=1.0.0.0, Culture=neutral, PublicKeyToken=4358f2a5344ff0dc</Assembly>
      <Class>MyEventHandlers.SimpleEventHandler</Class>
      <Data></Data>
      <Filter></Filter>
    </Receiver>
  </Receivers>
</Elements>

À propos des types de contenu

Les types de contenu sont des blocs de construction réutilisables dans le magasin de données SharePoint Foundation. Il est fréquent qu’un type de contenu dispose d’un ou plusieurs récepteurs d’événements dans le cadre de sa définition XML. Lorsque vous liez un type de contenu à une liste cible, par exemple, les récepteurs d’événements contenus dans ce type de contenu sont inscrits sur cette liste cible (ou liés à celle-ci).

Attention
Le vocabulaire des événements et des récepteurs d’événements utilise parfois les termes « inscrire » et « lier » indifféremment. Bien que cette documentation parle de « liaison » de récepteurs d’événements, vous pouvez parfois rencontrer des références à « l’inscription » de récepteurs d’événements. Les deux termes ont la même signification.

Windows SharePoint Services 3.0 a introduit le concept de types de contenu dans le magasin de données. En résumé, les types de contenu introduisent la notion de réutilisabilité. À l’aide de types de contenu, vous pouvez créer des classes d’objets avec des définitions spécifiques et un comportement associé possible, tels qu’un nom de type, des champs, un format, des processus d’entreprise, une rétention, un audit et une gestion d’événements.

Vous pouvez également activer des listes et des bibliothèques SharePoint pour prendre en charge plusieurs types de contenu. Lorsque vous effectuez cette opération, vous pouvez attacher une ou plusieurs de ces classes à votre liste ou bibliothèque et, ainsi, l’étendre avec des fonctionnalités et un comportement supplémentaires. Songez à étendre une liste de clients avec un type de contenu Contact. Le type de contenu Contact peut fournir à la liste Client un ensemble de nouveaux champs, tels que Nom du contact, Fonction, Téléphone, etc., ainsi qu’un nouveau comportement.

Si vous avez besoin de lier un gestionnaire d’événements à une liste ou bibliothèque spécifique, ou pour un ensemble spécifique de listes ou de bibliothèques, vous effectuez généralement cette opération au niveau du Composant fonctionnel. Toutefois, vous pouvez également réaliser cette opération à l’aide de la propriété EventReceivers sur l’objet approprié proprement dit (par exemple, sur les objets de liste ou de type de contenu, à l’aide de EventReceivers et EventReceivers respectivement).

Pour ce qui concerne les listes et bibliothèques, les Composants fonctionnels sont un concept atomique de SharePoint Foundation qui représente des sections CALM (Collaborative Application Markup Language) spécifiques qui étaient précédemment toutes consolidées dans un seul fichier (Schema.xml ou Onet.xml). Ces sections CALM sont isolées, ce qui signifie que vous pouvez les réutiliser dans différents endroits. Vous pouvez maintenant créer la structure et la définition de champ d’une liste à l’aide d’un Composant fonctionnel SharePoint.

Pour la liaison de votre gestionnaire d’événements, vous pouvez faire appel au concept de Composant fonctionnel pour lier votre assembly à une liste ou à une bibliothèque spécifique (en spécifiant le GUID de la liste ou de la bibliothèque) ou pour un certain type de liste ou de bibliothèque (par exemple, toutes les bibliothèques de documents ou toutes les bibliothèques de formulaires). Vous définissez un Composant fonctionnel en créant les deux mêmes types de fichiers XML (Feature.xml et Element.xml), comme indiqué dans Liaison d’un gestionnaire d’événements SharePoint Foundation.

Voir aussi

Partager via

Liaison de gestionnaires d’événements à l’aide de Composants fonctionnels SharePoint

Utilisation des Composants fonctionnels SharePoint

À propos des types de contenu

Voir aussi

Tâches

Concepts

Autres ressources

Ressources supplémentaires