Receivers-Element (Ereignis)
Letzte Änderung: Montag, 12. April 2010
Gilt für: SharePoint Foundation 2010
Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen
Enthält die Beschreibung eines Ereignisempfängers für die Verarbeitung von Elementereignissen in Listen, die mit der angegebenen Listenvorlage erstellt wurden.
<Receivers
ListTemplateId = "Text"
ListTemplateOwner = "Text"
ListUrl = string
RootWebOnly = TRUE | FALSE
Scope = Site | Web>
</Receivers>
Attribute
Attribut |
Beschreibung |
---|---|
ListTemplateId |
Optionaler Text-Wert. Gibt den Index der Listenvorlage an, auf den sich der Ereignisempfänger bezieht. Eine Liste der Standardtypen von Listenvorlagen finden Sie unter SPListTemplateType. |
ListTemplateOwner |
Optionaler Text-Wert. Gibt die GUID des Listenvorlagenbesitzers an, wenn die Listenvorlage über Features registriert wird, oder den Namen der Websitedefinition, wenn die Listenvorlage über eine Websitedefinition registriert wird. |
ListUrl |
Optionaler string-Wert. Gibt die URL der Liste an, auf die sich der Ereignisempfänger bezieht. |
RootWebOnly |
Optionaler Boolean-Wert. True, wenn sich der Ereignisempfänger nur auf die Stammwebsite bezieht, andernfalls False. |
Scope |
Optionaler enumeration-Wert. Der Bereich des Ereignisempfängers. Dieser kann Site oder Web sein. Wenn das Scope-Attribut auf Site festgelegt wird, werden Ereignisempfänger innerhalb eines Features mit dem Bereich der Websitesammlung auf Ebene der Websitesammlung registriert. Wenn das Scope-Attribut auf Web festgelegt wird, werden Ereignisempfänger, die innerhalb eines Features mit dem Bereich eines Webs definiert werden, in dem Web registriert. |
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen
Mindestvorkommen: 1 Maximum: Unbegrenzt |
Beispiel
Ein Beispiel für die Verwendung dieses Elements finden Sie unter Ereignisregistrierungen.
Ein Receivers-Tag kann ein Hinweis auf eine websiteweite Ereignisregistrierung oder eine Ereignisregistrierung für die Stammwebsite sein. Das Scope-Attribut definiert, auf welcher Ebene die Ereignisempfänger angewendet werden. Wenn das Receivers-Tag weder ein ListTemplateId-Attribut noch ein ListUrl-Attribut aufweist, ist der Ereignisempfänger im selben Bereich wie das Feature registriert. Ein Beispiel wäre ein Feature mit dem Bereich der Webergebnisse in einem Ereignisempfänger, das einer Ereignisempfängersammlung mit Webbereich hinzugefügt wird.