Neue Ereignisse in SharePoint Foundation 2010
Letzte Änderung: Donnerstag, 8. April 2010
Gilt für: SharePoint Foundation 2010
Inhalt dieses Artikels
Neue "Add"- und "Delete"-Ereignisse für Listen
Neue "Add"-Ereignisse für SharePoint-Websites
Neue synchrone "After"-Ereignisse
Für eine bessere Leistung und größere Flexibilität wurden der Microsoft SharePoint Foundation 2010-Entwicklerplattform mehrere neue Ereignisse hinzugefügt. Einen Katalog aller SharePoint Foundation-Ereignisse mit Anmerkungen dazu, welche dieser Ereignisse in SharePoint Foundation 2010 neu sind, finden Sie unter Katalog mit SharePoint Foundation-Ereignissen.
Neue "Add"- und "Delete"-Ereignisse für Listen
Für SharePoint-Listen, d. h. SPList-Objekte, wurden zwei neue Add-Ereignisse bereitgestellt:
Die Add-Ereignisse verwenden Eigenschaften, die von SPListEventProperties zur Verfügung gestellt und beim Erstellen einer neuen Liste ausgelöst werden.
Mit dem ListAdding-Ereignis können Benutzer die Erstellung der Liste abbrechen. Beachten Sie jedoch, dass die Listenerstellung nicht abgebrochen werden sollte, wenn Sie eine Websitevorlage oder Websitedefinition bereitstellen. Beachten Sie ferner, dass ListAdding-Ereignisse auftreten, wenn eine Website mithilfe der APIs im Microsoft.SharePoint.Deployment-Namespace wiederhergestellt wird.
Während der Bereitstellung einer Lösung können Sie nun Optionen festlegen, mit denen die während der Bereitstellung erfolgten Ereignisse ignoriert werden können. Das ListAdding-Ereignis tritt auch auf, wenn eine Liste nach ihrer Wiederverwendung wiederhergestellt wird. Dieses Verhalten ist mit der üblichen Funktionsweise von SharePoint-Listen konsistent. SPListEventProperties besitzt zwei weitere Eigenschaften (TemplateId und FeatureId), die als Parameter übergeben werden, sodass der Entwickler, der ein ListAdding-Ereignis verwendet, bestimmen kann, welcher Typ von Liste erstellt wird.
Zusätzlich zu diesen Add-Ereignissen wurden den SharePoint-Listen zwei Delete-Ereignisse hinzugefügt:
Mit diesen Delete-Ereignissen können Sie einen Listenlöschvorgang während seiner Ausführung abbrechen. Beim Abbrechen eines Löschvorgangs wird eine Fehlermeldung an die Benutzeroberfläche übergeben, und es wird eine Ausnahme ausgegeben. Beachten Sie, dass Delete-Ereignisse auch beim Wiederverwenden einer Liste auftreten (auch wenn die Liste technisch gesehen nicht gelöscht wird). Dieses Verhalten ist mit der üblichen Funktionsweise von SharePoint-Listenelementen konsistent.
Delete-Ereignisse treten in Objekten mit eingeschränktem Gültigkeitsbereich nicht auf, wenn Objekte auf höherer Ebene gelöscht werden. Wenn beispielsweise ein Delete-Ereignis auf Websiteebene auftritt, werden Ereignisse in weiter eingeschränkten Bereichen, z. B. Ereignisse in einzelnen Listenelementen, nicht ausgelöst. Daher ist es wichtig, beim Codieren von Löschereignissen die Ereignisbereiche zu beachten. Beachten Sie darüber hinaus, dass beim Löschen eines eigenständigen Listenordners (z. B. des Ordners Lists innerhalb einer Website) keine abfangbaren Ereignisse vorhanden sind und die List-Ereignisse nicht auftreten.
Neue "Add"-Ereignisse für SharePoint-Websites
Mit weiteren neuen Ereignissen werden die Steuerung und Flexibilität beim Erstellen einer SharePoint-Website (einer SPWeb-Instanz) verbessert. Beachten Sie jedoch, dass das Erstellen einer SharePoint-Website zwei einzelne Schritte erfordert: Zunächst fügen Sie einer Websitesammlung (SPSite-Instanz) eine Website hinzu. Zu diesem Zeitpunkt besteht die Website nur aus einem leeren Ordner mit einigen Eigenschaften. Anschließend stellen Sie im zweiten Schritt die Website bereit (d. h. Sie wenden eine Webvorlage an). Dann werden Elemente wie Listen, Dateien und andere Inhaltsobjekte instanziiert und auf der Grundlage der angegebenen Websitedefinition strukturiert.
Da die meisten wichtigen Aktionen während der Bereitstellungsphase auftreten, werden diese neuen auf die Website bezogenen Ereignisse mit dem Hinzufügen und Bereitstellen der Website verknüpft:
Das WebAdding-Ereignis wird ausgelöst, bevor eine neue Website erstellt wird. Wird der Erstellungsvorgang abgebrochen, wird keine SharePoint-Website erstellt, und der Bereitstellungsprozess wird nicht gestartet. Mithilfe des WebAdding-Ereignisses können Sie Aktivitäten wie eine bedingte Überprüfung ausführen, wodurch die Gültigkeit der URL sichergestellt werden kann. Oder es wird z. B. sichergestellt, dass der Benutzer, der eine Website erstellt, über die erforderlichen Anmeldinformationen verfügt.
Das WebProvisioned-Ereignis tritt auf, nachdem die Website vollständig bereitgestellt und der Bereitstellungsprozess beendet wurde. Dieses Ereignis kann so konfiguriert werden, dass es entweder im synchronen oder im asynchronen Modus ausgeführt werden kann. Verwenden Sie dieses Element zum Abschließen von Entwicklungsvorgängen, beispielsweise zum Hinzufügen von Webparts zur Website.
Neue synchrone "After"-Ereignisse
Mit synchronen after-Ereignissen sollen Aufgaben ausgeführt werden, die von asynchronen Ereignissen nur teilweise bewerkstelligt werden können. Dazu zählt die Fähigkeit, ein Listenelement nach seiner Übertragung in die Inhaltsdatenbank, jedoch vor der Anzeige des Listenelements für den Benutzer zu ändern. Beim Auftreten synchroner after-Ereignisse wird das Ereignis verarbeitet, bevor der Ereignishandler das Steuerelement freigibt.
.gif "Hinweis") Hinweis |
|---|
Das standardmäßige Synchronisierungsverhalten ist für before-Ereignisse synchron und für after-Ereignisse asynchron. |
Darüber hinaus ist eine neue Eigenschaft in der SPEventReceiverDefinition-Basisklasse verfügbar: Synchronization. Diese Eigenschaft bietet die Methoden get und set zum Abrufen und Festlegen des SPEventReceiverSynchronization-Enumerationswerts. Mit dieser Enumeration wird ein Default-Wert aus Gründen der Abwärtskompatibilität bereitgestellt.
Siehe auch
Konzepte
Verbesserungen beim Ereignismodell für SharePoint Foundation 2010