Élément SetVar (View)

Article
04/08/2023

S’applique à : | SharePoint 2016 SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013

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>

Éléments et attributs

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

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.
Valeur	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 a à la fois un formulaire couvrant et un formulaire non couvrant, ce qui <SetVar Name="MyVar">Announcements</SetVar> serait 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
AFFICHAGE	Utilisée lors du rendu de la section ViewBody d'un affichage.
MODIFIER	Utilisée lors du rendu d'un formulaire de modification.
DISPLAYHEAD	Utilisée lors du rendu de la section ViewHeader d'un affichage.
Nouveau	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.
APERÇUNOUVEAU	Utilisée lors de la modification d'un nouveau formulaire d'élément avec FrontPage.
APERÇUMODIFIER	Utilisée lors de la modification d'un formulaire de modification avec FrontPage.

Exemples

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 l’exemple suivant, le premier élément GetVar retourne Value_2 et le deuxième élément GetVar est retourné Value_1 , car l’élément SetVar qui contient Value_2 s’applique uniquement aux enfants de l’élément Sample . Value_2 sort 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"/>

L’exemple suivant évalue si un champ est obligatoire et, le cas échéant, crée l’astérisque rouge (*) qui s’affiche à côté des champs obligatoires dans les formulaires Nouveau ou Modifier et définit la variable HasRequired sur 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

Élément GetVar (View)

Partager via