SetList, élément (Affichage)
Dernière modification : vendredi 30 mai 2008
S’applique à : SharePoint Foundation 2010
Dans cet article
Attributs
Éléments enfants
Éléments parents
Occurrences
Désigne la liste active.
<SetList
Name = "Text"
PreserveContext = "TRUE" | "FALSE"
Scope = "Request">
</SetList>
Attributs
Attribut |
Description |
---|---|
Name |
Text obligatoire. Spécifie le nom de la liste. |
PreserveContext |
Boolean facultatif. 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 possède une forme développée et non développée ; ainsi <SetList>Announcements</SetList> correspond à <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 actuelle est temporairement assignée à une variable, Old, puis réinstanciée en tant que liste actuelle.
<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>