Inscriptions des événements
S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
Inscrivez les gestionnaires d’événements au niveau du site ou de la collection de sites que vous utiliserez pour implémenter le filtrage pour 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.
Exemple
Pour inscrire un gestionnaire d’événements pour les événements de liste, créez un dossier contenant \\Template\\Features un fichier Feature.xml qui spécifie l’étendue et l’ID de la fonctionnalité, ainsi qu’un fichier manifeste d’éléments référencé par l’ancien fichier.
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 du 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, consultez É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