É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 ( &nbsp; ).
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.

Voir aussi