GetVar, élément (View)

Article
09/24/2014

Dernière modification : vendredi 30 mai 2008

S’applique à : SharePoint Foundation 2010

Dans cet article
Attributs
Éléments enfants
Éléments parents
Occurrences

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>

Attributs

Attribut	Description
AutoHyperlink	Valeur Boolean facultative. Valeur TRUE pour entourer le texte de balises <A> si le texte s'affiche sous forme de lien hypertexte, par exemple, www.microsoft.com.
AutoHyperLinkNoEncoding	Valeur Boolean facultative. Valeur TRUE pour entourer le texte de balises <A> si le texte s'affiche sous forme de lien hypertexte (par exemple, www.microsoft.com), mais sans codage HTML.
AutoNewLine	Valeur Boolean facultative. Valeur TRUE pour insérer des balises <BR> dans le flux de texte et remplacer plusieurs espaces par un espace insécable ( ).
Default	Valeur Text facultative. Génère le texte affecté à cet attribut si la valeur renvoyée par l'attribut Select d'un autre élément est une chaîne vide.
ExpandXML	Valeur Boolean facultative. Valeur TRUE pour retransmettre le contenu généré par le biais de l'interpréteur CALM (Collaborative Application Markup Language), qui autorise CAML à générer CAML.
HTMLEncode	Valeur Boolean facultative. Valeur TRUE pour convertir des caractères incorporés afin de les afficher sous forme de texte dans le navigateur. En d'autres termes, les caractères susceptibles d'ê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	Valeur Boolean facultative. Valeur TRUE pour supprimer l'espace au début et à la fin de la valeur renvoyée par l'élément.
URLEncode	Valeur Boolean facultative. Valeur TRUE pour convertir des caractères spéciaux, tels que des espaces, en format UTF-8 entre guillemets, par exemple, %c3%ab pour le caractère ë.
URLEncodeAsUrl	Valeur Boolean facultative. Comme URLEncode, mais valeur TRUE pour spécifier que la chaîne à coder est un composant de chemin d'une URL de sorte que les barres obliques (« / ») ne soient pas codées.

Éléments enfants

Aucun

Éléments parents

Nombreux

Occurrences

Minimum : 0

Maximum : illimité

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 filtres sont ouverts dans la liste et si la variable Filter contient la valeur 1, « Hide Filter Choices » est affiché. Dans le cas contraire, 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 ; sinon, l'action par défaut consiste à afficher « Change Filter ».

Voir aussi

Référence

SetVar, élément (View)

Partager via