Поделиться через


Элемент Receivers (Event)

Дата последнего изменения: 9 марта 2015 г.

Применимо к: SharePoint Foundation 2010

В этой статье
Атрибуты
Дочерние элементы
Родительские элементы
Вхождения

Содержит описание получателя событий для обработки событий элемента в списках, созданных посредством указанного шаблона списков.

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

Атрибуты

Атрибут

Описание

ListTemplateId

Необязательный атрибут типа Text. Задает индекс шаблона списка, к которому применяется приемник событий. Список типов шаблонов списков, используемых по умолчанию, см. в разделе SPListTemplateType.

ListTemplateOwner

Необязательный атрибут типа Text. Указывает GUID владельца шаблона списка, если шаблон зарегистрирован с использованием компонентов, или имя определения сайта, если шаблон списка зарегистрирован с помощью определения сайта.

ListUrl

Необязательный атрибут типа string. Задает URL-адрес списка, к которому применяется приемник событий.

RootWebOnly

Необязательный атрибут типа Boolean. True, если приемник событий применяется только к корневому веб-сайту, в противном случае False.

Scope

Необязательный атрибут типа enumeration. Область действия приемника событий. Ею может быть Site или Web. Если атрибут Scope имеет значение Site, приемники событий, определенные в компоненте, областью действия которого является семейство сайтов, регистрируются на уровне семейства сайтов. Если атрибут Scope имеет значение Web, приемники событий, определенные в компоненте с областью действия в веб-сайте, регистрируются в этом веб-сайте.

Дочерние элементы

Receiver

Родительские элементы

Elements

Вхождения

Минимум: 1

Максимум: без ограничений

Пример

Пример использования этого элемента см. в разделе Регистрации событий.

Тег Receivers может означать регистрацию событий на всем сайта или только на корневом сайте. Атрибут Scope позволяет определить уровень, на котором применяются приемники событий. Если у тега Receivers нет атрибута ListTemplateId или ListUrl, приемник событий регистрируется в той же области, что и компонент. Например, если компонент зарегистрирован в корневом сайте, приемник событий добавляется в коллекцию приемников событий, отвечающих за корневой сайт.