GetVar, élément (View)
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 ».