Élément GetVar (View)
S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | SharePoint En ligne | SharePoint Server 2013
Renvoie une variable dans le contexte du rendu de la page. Vous pouvez définir les variables localement au niveau actuel du XML ou globalement dans la page.
<GetVar
AutoHyperlink = "TRUE" | "FALSE"
AutoHyperLinkNoEncoding = "TRUE" | "FALSE"
AutoNewLine = "TRUE" | "FALSE"
Default = "TRUE" | "FALSE"
ExpandXML = "TRUE" | "FALSE"
HTMLEncode = "TRUE" | "FALSE"
Name = "Text"
Scope ="Request"
StripWS = "TRUE" | "FALSE"
URLEncode = "TRUE" | "FALSE"
URLEncodeAsURL = "TRUE" | "FALSE">
</GetVar>
Éléments et attributs
Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.
Attributs
| Attribut | Description |
|---|---|
| AutoHyperlink |
Facultatif Boolean. TRUE pour entourer le texte de balises si le texte apparaît comme un <A> lien hypertexte, par exemple, www.microsoft.com . |
| AutoHyperLinkNoEncoding |
Facultatif Boolean. TRUE pour entourer le texte de balises si le texte s’affiche comme un <A> lien hypertexte (par exemple), mais sans www.microsoft.com codage HTML. |
| AutoNewLine |
Facultatif Boolean. TRUE pour insérer <BR> des balises dans le flux de texte et remplacer plusieurs espaces par un espace sans rupture ( ). |
| Par défaut |
Valeur Text facultative. Génère le texte affecté à cet attribut si la valeur retournée par l'attribut Select d'un autre élément est une chaîne vide. |
| ExpandXML |
Boolean facultatif. TRUE pour repasser le contenu rendu via l'interpréteur CAML (Collaborative Application Markup Language), ce qui permet à l'interpréteur CAML de rendre le CAML. |
| HTMLEncode |
Boolean facultatif. TRUE pour convertir des caractères incorporés de façon à ce que qu'ils s'affichent en tant que texte dans le navigateur. En d'autres termes, les caractères qui peuvent être confondus avec des balises HTML sont convertis en entités. |
| Nom |
Valeur Text obligatoire. Nom de la variable. |
| Scope |
Si elle est définie sur Request, la variable est globalement disponible sur la page. |
| StripWS |
Boolean facultatif. TRUE pour supprimer des espaces au début et à la fin de la valeur renvoyée par l'élément. |
| URLEncode |
Facultatif Boolean. TRUE pour convertir des caractères spéciaux, tels que des espaces, au format UTF-8, par exemple, %c3%ab pour le caractère ë . |
| URLEncodeAsUrl |
Facultatif Boolean. Comme URLEncode, mais TRUE pour spécifier que la chaîne à coder est un composant de chemin d’accès d’une URL afin que les barres obliques ( ) ne soient pas / codées. |
Éléments enfants
Aucun
Éléments parents
Nombreux
Occurrences
- Minimum : 0
- Maximum : pas de limite
Remarques
L'élément GetVar est souvent utilisé au sein d'un élément Expr dans un élément Switch ou IfEqual.
Si Scope="Request" est spécifié dans l'élément SetVar, l'affectation de la variable s'effectue n'importe où sur la page active. Sinon, la variable n'affecte que les enfants de l'élément SetVar.
Exemple
L'exemple suivant utilise l'élément GetVar pour renvoyer les informations de filtrage en cours afin de déterminer le texte à afficher dans la barre d'outils au-dessus de la liste.
<Switch>
<Expr>
<GetVar Name="Filter" />
</Expr>
<Case Value="1">
<HTML>Hide Filter Choices</HTML>
</Case>
<Default>
<Switch>
<Expr>
<GetVar Name="FilterField1" />
</Expr>
<Case Value="">
<HTML>Filter</HTML>
</Case>
<Default>
<HTML>Change Filter</HTML>
</Default>
</Switch>
</Default>
</Switch>
Si les choix de filtre sont ouverts dans la liste et que la variable Filter contient 1, masquer les choix de filtre s’affiche. Si ce n’est pas le cas, l’action par défaut implémente une deuxième instruction Switch qui évalue une deuxième variable, FilterField1. Si la valeur de FilterField1 est une chaîne vide, aucun filtre n’est appliqué et Filter est affiché dans la barre d’outils ; Dans le cas contraire, l’action par défaut consiste à afficher le filtre de modification.