Enregistrement d'événements
Dernière modification : mercredi 24 mars 2010
S’applique à : SharePoint Foundation 2010
Enregistrez les gestionnaires d’événements au niveau du site ou de la collection de sites que vous allez utiliser pour implémenter le filtrage afin de répondre à des événements.
L'élément Receivers spécifie un gestionnaire d'événements pour des événements d'éléments de liste.
Synchronization, élément (Event)
Exemple
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="https://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="https://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 Événements dans SharePoint Foundation 2010.
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.";
}
}
}
Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SharePoint
Namespace MS.Samples
Public Class SimpleItemUpdateHandler
Inherits SPItemEventReceiver
Public Overrides Sub ItemUpdating(ByVal properties As SPItemEventProperties)
properties.Status = SPEventReceiverStatus.CancelWithError
properties.ErrorMessage = "Updating data is not supported."
End Sub
End Class
End Namespace
Voir aussi
Tâches
Procédure : créer une fonctionnalité Gestionnaire d'événements