Élément SetList (View)
S’applique à : | SharePoint 2016 SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013
Désigne la liste active.
<SetList
Name = "Text"
PreserveContext = "TRUE" | "FALSE"
Scope = "Request">
</SetList>
Éléments et attributs
Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.
Attributs
| Attribut | Description |
|---|---|
| Nom |
Text obligatoire. Spécifie le nom de la liste. |
| PreserveContext |
Facultatif Boolean. Si la valeur est FALSE, l'implémentation de l'élément SetList exécute à nouveau la requête de base de données nécessaire pour extraire les données d'un formulaire qui affiche un seul élément de liste. Cette fonctionnalité est utile lorsqu'un affichage et un formulaire sont sur la même page. La valeur par défaut est TRUE. |
| Scope |
Lorsqu'il prend la valeur Request, cet attribut rend la liste globalement disponible pour la page. |
Éléments enfants
Aucun
Éléments parents
Occurrences
- Minimum : 0
- Maximum : 1
Remarques
Lorsque vous utilisez l'élément SetList, vous devez utiliser le nom interne, qui ne contient pas d'espaces et est invariant.
L’élément SetList a à la fois un formulaire couvrant et un formulaire de non-mise en forme, ce qui <SetList>Announcements</SetList> serait identique à <SetList Name="Announcements"/>.
L'élément SetList est souvent un enfant d'un élément Method utilisé dans le traitement par lots des demandes.
Exemple
L'exemple suivant renvoie la valeur du champ Title de la table Lists dans la base de données si la liste actuelle correspond à la liste qui est recherchée. Initialement, la liste active est temporairement affectée à une variable Old , puis rétablie en tant que liste active.
<SetVar Scope="Request" Name="Old">
<List/>
</SetVar>
<SetList>
<GetVar Name="Lookup"/>
</SetList>
<IfEqual>
<Expr1>
<List/>
</Expr1>
<Expr2>
<GetVar Name="Lookup"/>
</Expr2>
<Then>
<ListProperty HTMLEncode="TRUE" Select="Title"/>
</Then>
</IfEqual>
<SetList><GetVar Name="Old"/></SetList>