Receivers, élément (Event)

S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | SharePoint En ligne | SharePoint Server 2013

Contient la description d'un récepteur d'événements pour gérer des événements d'élément dans des listes créées au moyen du modèle de liste spécifié.

Définition

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

Éléments et attributs

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut

Description

**ListTemplateId**

**Text** facultatif. Spécifie l'index du modèle de liste auquel le récepteur d'événements s'applique. Pour obtenir la liste des types de modèles de liste par défaut, voir SPListTemplateType.

**ListTemplateOwner**

Texte **facultatif**. Spécifie le GUID du propriétaire du modèle de liste si le modèle de liste est inscrit via les fonctionnalités, ou le nom de la définition de site si le modèle de liste est inscrit par une définition de site.

**ListUrl**

Chaîne **facultative**. Spécifie l’URL de la liste à laquelle le récepteur d’événements s’applique.

**RootWebOnly**

Facultatif **Boolean**. **True si** le récepteur d’événements s’applique uniquement au site Web racine ; sinon, **False**.

**Scope**

**Éumération facultative**. Étendue du récepteur d’événements. Il peut s’y **trouver site** ou **web.** Lorsque **l’attribut Scope** est défini sur **Site,** les récepteurs d’événements qui sont définis à l’intérieur d’une fonctionnalité qui est étendue à la collection de sites sont inscrits au niveau de la collection de sites. Lorsque **l’attribut Scope** est défini sur **Web,** les récepteurs d’événements qui sont définis à l’intérieur d’une fonctionnalité qui est limitée à un Site Web sont inscrits sur le Web.

Éléments enfants

Récepteur

Éléments parents

Éléments

Occurrences

Minimum : 1

Maximum : pas de limite

Exemple

Pour obtenir un exemple de la façon dont cet élément est utilisé, voir Event Registrations.

Une balise Receivers peut impliquer une inscription d’événement à l’échelle du site ou une inscription d’événement pour le site web racine. L’attribut Scope est utilisé pour définir à quel niveau les récepteurs d’événements sont appliqués. Si la balise Receivers n’a pas d’attribut ListTemplateId ou ListUrl, le récepteur d’événements est inscrit dans la même étendue que la fonctionnalité.

Par exemple, une fonctionnalité qui est limitée au Web entraîne l’ajout d’un récepteur d’événements à une collection de récepteurs d’événements qui est étendue au Web.