Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Enregistrement d'événements

Dernière modification :vendredi 15 juillet 2011

S’applique à :SharePoint Foundation 2013 | SharePoint Server 2013

Inscrire des gestionnaires d'événements au niveau du site ou d'un niveau de collection de sites que vous allez utiliser pour implémenter le filtrage afin de répondre aux événements.

L'élément Receivers spécifie un gestionnaire d'événements pour des événements d'éléments de liste.

Éléments

Récepteurs

Receiver

Assembly :

Classe

données

Filter, élément (événement)

« name »

SequenceNumber

SolutionId, élément (événement)

La synchronisation, élément (événement)

« type »

Pour enregistrer un gestionnaire d'événements pour des événements de liste, créez dans \Template\Features un dossier devant contenir un fichier Feature.xml qui spécifie l'étendue et l'ID du composant fonctionnel, et un fichier manifeste des éléments auquel l'ancien fichier fait référence.

Le fichier Feature.xml qui enregistre un gestionnaire d'événements peut ressembler à celui-ci.

<Feature 
  Scope="Web" 
  Title="Simple Updating Item Event Handler Registration" 
  Id="A6B8687A-3200-4b01-AD76-09E8D163FB9A" 
  xmlns="http://schemas.microsoft.com/sharepoint/">
  <ElementManifests>
    <ElementManifest Location="elements.xml"/>
  </ElementManifests>
</Feature>

Le fichier manifeste des éléments enregistre l'assembly du gestionnaire d'événements et associe celui-ci à un type de liste qui, dans l'exemple suivant, est une liste d'annonces (104).

<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
  <Receivers 
    ListTemplateId="104">
    <Receiver>
      <Name>SimpleUpdateEvent</Name>
      <Type>ItemUpdating</Type>
      <SequenceNumber>10000</SequenceNumber>
      <Assembly>SimpleUpdateEventHandler, Version=1.0.0.0, Culture=neutral, PublicKeyToken=10b23036c9b36d6d</Assembly>
      <Class>MS.Samples.SimpleItemUpdateHandler</Class>
      <Data></Data>
    </Receiver>
  </Receivers>
</Elements>

Le fichier .cs pour le gestionnaire d'événements peut utiliser le modèle objet SharePoint Foundation pour répondre aux événements. Pour plus d'informations sur l'utilisation du modèle objet pour créer des gestionnaires d'événements personnalisés, voir Principes des événements.

L'exemple suivant définit le contenu d'un message d'erreur à afficher lorsque des utilisateurs tentent de modifier des éléments d'une liste.

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SharePoint;

namespace MS.Samples
{
    public class SimpleItemUpdateHandler : SPItemEventReceiver
    {
        public override void ItemUpdating(SPItemEventProperties properties)
        {
            properties.Cancel = true;
            properties.ErrorMessage = "Updating data is not supported.";
        }
    }
}
Afficher: