Élément GetVar (View)
S’applique à : | SharePoint 2016 SharePoint Foundation 2013 | | SharePoint Online 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 |
|---|---|
| Lien automatique |
Facultatif Boolean. TRUE pour entourer le texte de <A> balises si le texte apparaît comme un lien hypertexte, par exemple. www.microsoft.com |
| AutoHyperLinkNoEncoding |
Facultatif Boolean. TRUE pour entourer le texte de <A> balises si le texte apparaît comme un lien hypertexte (par exemple, www.microsoft.com), mais sans encodage 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 |
Texte facultatif. 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 |
Facultatif Boolean. 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 |
Facultatif Boolean. 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. |
| Name |
Valeur Text obligatoire. Nom de la variable. |
| Scope |
Si elle est définie sur Request, la variable est globalement disponible sur la page. |
| StripWS |
Facultatif Boolean. 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 entre guillemets, par exemple pour %c3%ab le caractère ë. |
| URLEncodeAsUrl |
Facultatif Boolean. Comme URLEncode, mais TRUE pour spécifier que la chaîne à encoder est un composant de chemin d’accès d’une URL afin que les barres obliques (/) ne soient pas encodé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. Dans le cas contraire, l'assignation affecte uniquement 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 Filtre 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 Filtre est affiché dans la barre d’outils ; sinon, l’action par défaut consiste à afficher modifier le filtre.