Élément SetVar (View)

S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | SharePoint En ligne | 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.
Nom
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 possède à la fois une forme couvrante et une forme non couvrante, ce <SetVar Name="MyVar">Announcements</SetVar> qui serait le même que <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.
| |**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.
| |**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.
| ## 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 est renvoie et le second élément GetVar est de retour car l’élément SetVar qui contient s’applique uniquement aux enfants de Value_2 Value_1 Value_2 l’élément Sample. Value_2 sort de l’étendue après la balise De l’exemple de fermeture.

<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, si nécessaire, crée l’astérisque rouge ( ) qui est affiché à 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