SetVar, élément (View)SetVar element (View)

S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013Applies to: 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.Allows variables to be set in the context of rendering the page—either locally to the current level of XML or globally to the page.

<SetVar
  ID = "Text"
  Name = "Text"
  Scope = "Request"
  Value = "Text">
</SetVar>

Éléments et attributsElements and attributes

Les sections suivantes décrivent les attributs, éléments enfants et éléments parents.The following sections describe attributes, child elements, and parent elements.

AttributsAttributes

AttributAttribute DescriptionDescription
IDID
Facultatif texte.Optional Text. Fournit un ID de la variable.Provides an ID for the variable.
NomName
Textobligatoire.Required Text. Spécifie un nom pour la variable.Specifies a name for the variable.
ScopeScope
Si la valeur Request, la variable est globale.If set to Request, the variable is global.
ValeurValue
Facultatif texte.Optional Text. Peut être utilisé pour assigner une valeur à la variable lorsqu’il s’agit d’un élément vide.Can be used to assign a value to the variable when this is an empty element.

Éléments enfantsChild elements

AucunNone

Éléments parentsParent elements

NombreuxNumerous

OccurrencesOccurrences

  • Minimum : 0Minimum: 0
  • Maximum : UnboundedMaximum: Unbounded

RemarquesRemarks

L’élément SetVar a réparti et un formulaire non réparti, afin que <SetVar Name="MyVar">Announcements</SetVar> serait identique <SetVar Name="MyVar" Value="Announcements/>.The SetVar element has both a spanning and a non-spanning form, so that <SetVar Name="MyVar">Announcements</SetVar> would be the same as <SetVar Name="MyVar" Value="Announcements/>.

Si étendue = « Request » est spécifié dans l’élément SetVar , une affectation de variable prend effet n’importe où dans la page actuelle.If Scope="Request" is specified in the SetVar element, a variable assignment takes effect anywhere in the current page. Dans le cas contraire, l’affectation concerne uniquement les enfants de l’élément SetVar .Otherwise, the assignment affects only children of the SetVar element.

L’élément SetVar est souvent un enfant d’un élément Method utilisé dans le traitement par lots des demandes.The SetVar element is often a child to a Method element used in batch processing of requests.

L’élément SetVar est fréquemment utilisé pour modifier le mode d’affichage en affectant à DisplayMode une des valeurs suivantes.The SetVar element is frequently used to change the display mode by setting DisplayMode to one of the following values.


ValeurValue DescriptionDescription
AFFICHAGEDISPLAY
Utilisé lors du rendu de la section ViewBody d’un affichage.Used when rendering the ViewBody section of a view.
MODIFIEREDIT
Utilisée lors du rendu d'un formulaire de modification.Used when rendering an edit item form.
DISPLAYHEADDISPLAYHEAD
Utilisé lors du rendu de la section ViewHeader d’un affichage.Used when rendering the ViewHeader section of a view.
NouveauNEW
Utilisée lors du rendu d'un nouveau formulaire d'élément.Used when rendering a new item form.
PREVIEWDISPLAYPREVIEWDISPLAY
Utilisé lors de la modification d'un formulaire d'affichage avec Microsoft FrontPage.Used when editing a display form with Microsoft FrontPage.
PREVIEWNEWPREVIEWNEW
Utilisée lors de la modification d'un nouveau formulaire d'élément avec FrontPage.Used when editing a new item form with FrontPage.
PREVIEWEDITPREVIEWEDIT
Utilisée lors de la modification d'un formulaire de modification avec FrontPage.Used when editing an edit item form with FrontPage.

ExemplesExamples

L’exemple suivant illustre l’utilisation de l’élément SetVar pour définir l’étendue globale pour une variable.The following example illustrates using the SetVar element to set global scope for a variable. La deuxième ligne renvoie la valeur définie dans la première ligne.The second line returns the value set in the first line.

<SetVar Name="GlobalVar" Scope="Request">Value</SetVar>
...
<GetVar Name="GlobalVar">


Dans l’exemple suivant, le premier élément GetVar renvoie Value_2 et retourne le deuxième élément GetVar Value_1 , car l’élément SetVar qui contient Value_2 s’applique uniquement aux enfants de l’élément exemple .In the following example, the first GetVar element returns Value_2 and the second GetVar element returns Value_1 because the SetVar element that contains Value_2 applies only to children of the Sample element. Value_2après la balise de l’exemple de fermeture, est hors de portée.Value_2 goes out of scope after the closing Sample tag.

<SetVar Name="myVar">Value_1</SetVar>
   <Sample>
      <SetVar Name="myVar">Value_2</SetVar>
      <GetVar Name="myVar"/>
   </Sample>
   <GetVar Name="myVar"/>


L’exemple suivant détermine si un champ est obligatoire et, si nécessaire, crée l’astérisque rouge (*) qui s’affiche en regard des champs obligatoires dans nouveau ou modifier des formulaires et définit la variable HasRequired la valeur True.The following example evaluates whether a field is required and, if it is required, creates the red asterisk (*) that is displayed beside required fields in New or Edit forms and sets the HasRequired variable to 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 aussiSee also