SetVar, é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
Permet de définir des variables dans le contexte de rendu de la page, localement au niveau actuel du XML ou globalement dans la page.
<SetVar
ID = "Text"
Name = "Text"
Scope = "Request"
Value = "Text">
</SetVar>
Attributs
Attribut |
Description |
---|---|
ID |
Facultatif Text. Fournit un ID pour la variable. |
Name |
Obligatoire Text. Spécifie un nom pour la variable. |
Scope |
Si défini sur Request, la variable est globale. |
Value |
Facultatif Text. Peut servir à affecter une valeur à la variable lorsqu'il s'agit d'un élément vide. |
Éléments enfants
Aucun |
Éléments parents
Nombreux |
Occurrences
Minimum : 0 Maximum : pas de limite |
Remarques
L'élément SetVar contient un formulaire réparti et non réparti, afin que <SetVar Name="MyVar">Announcements</SetVar> soit identique à <SetVar Name="MyVar" Value="Announcements/>.
Si Scope="Request" est spécifié dans l'élément SetVar, une assignation de variable est appliquée n'importe où dans la page active. Dans le cas contraire, l'assignation affecte uniquement les enfants de l'élément SetVar.
L'élément SetVar est souvent l'enfant d'un élément Method utilisé dans le traitement par lots des demandes.
L'élément SetVar est fréquemment utilisé pour modifier le mode d'affichage en affectant à DisplayMode l'une des valeurs suivantes :
Valeur |
Description |
---|---|
DISPLAY |
Utilisée lors du rendu de la section ViewBody d'un affichage. |
EDIT |
Utilisée lors du rendu d'un formulaire de modification. |
DISPLAYHEAD |
Utilisée lors du rendu de la section ViewHeader d'un affichage. |
NEW |
Utilisée lors du rendu d'un nouveau formulaire d'élément. |
PREVIEWDISPLAY |
Utilisé lors de la modification d'un formulaire d'affichage avec Microsoft FrontPage. |
PREVIEWNEW |
Utilisée lors de la modification d'un nouveau formulaire d'élément avec FrontPage. |
PREVIEWEDIT |
Utilisée lors de la modification d'un formulaire de modification avec FrontPage. |
Exemple
Le code exemple suivant illustre l'utilisation de l'élément SetVar pour définir une étendue globale pour une variable. La deuxième ligne renvoie la valeur définie dans la première ligne.
<SetVar Name="GlobalVar" Scope="Request">Value</SetVar>
...
<GetVar Name="GlobalVar">
Dans le code exemple suivant, le premier élément GetVar renvoie « Value_2 » et le deuxième élément GetVar renvoie « Value_1 », parce que l'élément SetVar qui contient « Value_2 » s'applique uniquement aux enfants de l'élément « Sample ». « Value_2 » ne fait plus partie de l'étendue après la fermeture de la balise « Sample ».
<SetVar Name="myVar">Value_1</SetVar>
<Sample>
<SetVar Name="myVar">Value_2</SetVar>
<GetVar Name="myVar"/>
</Sample>
<GetVar Name="myVar"/>
Le code exemple suivant évalue si un champ est obligatoire ou non et, si c'est le cas, crée l'astérisque rouge (*) qui s'affiche en regard des champs obligatoires dans les nouveaux formulaires ou les formulaires de modification, puis affecte à la variable HasRequired la valeur TRUE.
<Switch>
<Expr>
<Property Select="Required"/>
</Expr>
<Case Value="TRUE">
<HTML><![CDATA[<font color=red> *</font>]]></HTML>
<SetVar Scope="Request" Name="HasRequired">TRUE</SetVar>
</Case>
</Switch>