SetVar, é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

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>

Voir aussi

Référence

GetVar, élément (View)

Partager via