Ereignisregistrierungen
Letzte Änderung: Mittwoch, 24. März 2010
Gilt für: SharePoint Foundation 2010
Registrieren Sie Ereignishandler auf Website- oder Websitesammlungsebene, die Sie zum Implementieren der Filterung verwenden, um auf Ereignisse zu reagieren.
Das Receivers-Element gibt einen Ereignishandler für Listenelementereignisse an.
Synchronization-Element (Ereignis)
Beispiel
Erstellen Sie zum Registrieren eines Ereignishandlers für Listenereignisse in \Template\Features einen Ordner zum Ablegen der Datei Feature.XML, die den Gültigkeitsbereich und die ID des Features sowie eine Elementmanifestdatei angibt, auf die erstere Datei verweist.
Mithilfe der Datei Feature.XML wird ein Ereignishandler registriert, der wie folgt aussehen kann.
<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>
Die Elementmanifestdatei registriert die Ereignishandlerassembly und ordnet sie einem Listentyp zu, der im folgenden Beispiel als Ankündigungsliste (104) angegeben wird.
<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>
Die CS-Datei für den Ereignishandler kann zum Reagieren auf Ereignisse das SharePoint Foundation-Objektmodell verwenden. Weitere Informationen zum Verwenden des Objektmodells zum Erstellen benutzerdefinierter Ereignishandler finden Sie unter Ereignisse in SharePoint Foundation 2010.
Das folgende Beispiel gibt den Inhalt einer Fehlermeldung an, die angezeigt wird, wenn Benutzer versuchen, Elemente in einer Liste zu ändern.
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
Siehe auch
Aufgaben
Gewusst wie: Erstellen eines Ereignishandlerfeatures