Receivers-Element (Ereignis)Receivers Element (Event)

Betrifft: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Enthält die Beschreibung eines Ereignisempfängers für die Verarbeitung von Elementereignissen in Listen, die mit der angegebenen Listenvorlage erstellt wurden.Contains the description of an event receiver for handling item events in lists created through the specified list template.

DefinitionDefinition

<Receivers
  ListTemplateId = "Text"
  ListTemplateOwner = "Text"
  ListUrl = string
  RootWebOnly = TRUE | FALSE
  Scope = Site | Web>
</Receivers>

Elemente und AttributeElements and attributes

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.The following sections describe attributes, child elements, and parent elements.

AttributeAttributes

AttributAttribute

BeschreibungDescription

ListTemplateIdListTemplateId

Optionaler Text-Wert.Optional Text. Gibt den Index der Listenvorlage auf der der Ereignisempfänger angewendet wird.Specifies the index of the list template to which the event receiver applies. Eine Liste mit der standardmäßigen Vorlage Listentypen finden Sie unter SPListTemplateType.For a list of the default list template types, see SPListTemplateType.

ListTemplateOwnerListTemplateOwner

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.Optional Text. Specifies the GUID of the list template owner if the list template is registered through Features, or the name of the site definition if the list template is registered by a site definition.

ListUrlListUrl

Optionaler string-Wert. Gibt die URL der Liste an, auf die sich der Ereignisempfänger bezieht.Optional string. Specifies the URL of the list to which the event receiver applies.

RootWebOnlyRootWebOnly

Optionaler Boolean-Wert. True, wenn sich der Ereignisempfänger nur auf die Stammwebsite bezieht, andernfalls False.Optional Boolean. True if the event receiver applies only to the root Web; otherwise, False.

ScopeScope

Optional- Enumeration.Optional enumeration. Der Bereich des Ereignisempfängers.The scope of the event receiver. Dies kann die Website oder den Webdienstsein.This can be Site or Web. Wenn das Scope -Attribut auf Websitefestgelegt ist, werden auf der Ebene der Websitesammlung Ereignisempfänger, die innerhalb eines Features definiert sind, die für die Websitesammlung ausgelegt ist registriert.When the Scope attribute is set to Site, event receivers that are defined inside of a Feature that is scoped to the site collection are registered at the site collection level. Wenn das Scope -Attribut auf Webfestgelegt ist, werden im Web-Ereignisempfänger, die innerhalb eines Features definiert sind, die in einem Web ausgelegt ist registriert.When the Scope attribute is set to Web, event receivers that are defined inside of a Feature that is scoped to a Web are registered on the Web.

Untergeordnete ElementeChild elements

EmpfängerReceiver

Übergeordnete ElementeParent elements

ElementeElements

VorkommenOccurrences

Minimum: 1Minimum: 1

Maximum: UnbegrenztMaximum: Unbounded

BeispielExample

Ein Beispiel für die Verwendung dieses Elements finden Sie unter Event Registrations.For an example of how this element is used, see Event Registrations.

Ein Ereignisempfänger Tag kann die ereignisregistrierung eines websiteweiten oder eine Registrierung eines Ereignisses für das Stammweb implizieren.A Receivers tag can imply a site-wide event registration or an event registration for the root Web. Das Scope -Attribut wird definiert, auf welcher Ebene der Ereignisempfänger angewendet werden.The Scope attribute is used to define at what level the event receivers are applied. Wenn das Tag Ereignisempfänger kein ListTemplateId oder ListUrl -Attribut verfügt, wird der Ereignisempfänger auf derselben Ebene wie das Feature registriert.If the Receivers tag has no ListTemplateId or ListUrl attribute, the event receiver is registered at the same scope as the Feature.

Beispielsweise erzeugt einen Ereignisempfänger hinzugefügte Event Receiver-Auflistung, die im Web ausgelegt ist ein Feature, das im Web ausgelegt ist.For example, a Feature that is scoped to the Web results in an event receiver being added to an event receiver collection that is scoped to the Web.