Compartilhar via


Elemento Receivers (evento)

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013

Contém a descrição de um receptor de eventos para lidar com eventos de item em listas criadas por meio do modelo de lista especificado.

Definição

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

Elementos e atributos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo Descrição
ListTemplateId Texto opcional. Especifica o índice do modelo de lista ao qual o receptor de eventos se aplica. Para obter uma lista dos tipos de modelo de lista padrão, consulte SPListTemplateType.
ListTemplateOwner Texto opcional. Especifica o GUID do proprietário do modelo de lista se o modelo de lista for registrado por meio de Recursos ou o nome da definição do site se o modelo de lista for registrado por uma definição de site.
ListUrl Cadeia de caracteres opcional. Especifica a URL da lista à qual o receptor de eventos se aplica.
RootWebOnly Booliano opcional. True se o receptor de eventos se aplicar somente à Web raiz; caso contrário, False.
Escopo Enumeração opcional. O escopo do receptor de eventos. Isso pode ser Site ou Web. Quando o atributo Scope é definido como Site, os receptores de eventos definidos dentro de um recurso que está no escopo da coleção de sites são registrados no nível da coleção do site. Quando o atributo Scope é definido como Web, os receptores de eventos definidos dentro de um recurso que está no escopo de uma Web são registrados na Web.

Elementos filho

Receptor

Elementos pai

Elementos

Occurrences

Mínimo: 1

Máximo: Desvinculado

Exemplo

Para obter um exemplo de como esse elemento é usado, consulte Registros de Eventos.

Uma marca Receptores pode implicar um registro de evento em todo o site ou um registro de evento para a Web raiz. O atributo Scope é usado para definir em que nível os receptores de evento são aplicados. Se a marca Receivers não tiver atributo ListTemplateId ou ListUrl , o receptor de eventos será registrado no mesmo escopo que o Recurso.

Por exemplo, um recurso que é escopo para a Web resulta em um receptor de eventos sendo adicionado a uma coleção de receptores de eventos que tem escopo para a Web.