使用英语阅读

通过

Receivers 元素（事件）

  • 项目

适用于：SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

包含一个事件接收器的说明，该事件接收器用于处理通过指定列表模板创建的列表中的项目事件。

定义

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

元素和属性

下面各部分介绍了属性、子元素和父元素。

Attributes

属性 说明
ListTemplateId 可选属性，类型为 Text。 指定应用事件接收器的列表模板的索引。 有关默认列表模板类型的列表，请参阅 SPListTemplateType。
ListTemplateOwner 可选属性，类型为 Text。 如果通过功能对列表模板进行注册，则指定该列表模板所有者的 GUID；如果通过网站定义对列表模板进行注册，则指定该网站定义的名称。
ListUrl 可选属性，类型为 string。 指定应用事件接收器的列表的 URL。
RootWebOnly 可选属性，类型为 Boolean。 如果事件接收器仅应用于根网站，则为 True；否则为 False。
Scope 可选属性，类型为 enumeration。 事件接收器的范围。 它可以为 Site 或 Web。 当 Scope 属性设置为 Site 时，会在网站集级别注册范围扩展到网站集的功能中定义的事件接收器。 当 Scope 属性设置为 Web 时，在限定为 Web 的功能中定义的事件接收器在 Web 上注册。

子元素

接收机

父元素

元素

出现次数

最小值：1

最大值：无限制

示例

有关如何使用此元素的示例，请参阅Event Registrations。

Receivers 标记可表示网站范围的事件注册或根网站的事件注册。 Scope 属性用于定义应用事件接收器的级别。 如果 Receivers 标记没有 ListTemplateId 或 ListUrl 属性，则会在与功能相同的范围注册事件接收器。

例如，如果功能的范围扩展到网站，则会将事件接收器添加到范围扩展到网站的事件接收器集合中。