Elemento SetVar (Vista)
Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
Permite establecer variables en el contexto de representación de la página, ya sea localmente en el nivel actual de XML o globalmente en la página.
<SetVar
ID = "Text"
Name = "Text"
Scope = "Request"
Value = "Text">
</SetVar>
Elementos y atributos
En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.
Atributos
| Atributo | Descripción |
|---|---|
| Id. |
Text opcional. Proporciona un identificador para la variable. |
| Nombre |
Text obligatorio. Especifica un nombre para la variable. |
| Scope |
Si está establecido en Request, la variable es global. |
| Valor |
Text opcional. Puede usarse para asignar un valor a la variable cuando es un elemento vacío. |
Elementos secundarios
Ninguno
Elementos principales
Numerosos
Repeticiones
- Mínimo: 0
- Máximo: sin límite
Comentarios
El elemento SetVar tiene un formato de expansión y de no expansión, por lo que sería igual <SetVar Name="MyVar" Value="Announcements/>que <SetVar Name="MyVar">Announcements</SetVar> .
Si se especifica Scope="Request" en el elemento SetVar, una asignación de variable surte efecto en cualquier lugar en la página actual. De lo contrario, la asignación afecta sólo a los elementos secundarios del elemento SetVar.
El elemento SetVar a menudo es un elemento secundario de un elemento Method usado en el procesamiento por lotes de solicitudes.
El elemento SetVar con frecuencia se usa para cambiar el modo de presentación al establecer DisplayMode en uno de los siguientes valores.
| Valor | Descripción |
|---|---|
| MONITOR |
Se usa cuando se representa la sección ViewBody de una vista. |
| EDITAR |
Se usa cuando se representa un formulario de elementos de edición. |
| DISPLAYHEAD |
Se usa cuando se representa la sección ViewHeader de una vista. |
| Nuevo |
Se usa cuando se representa un nuevo formulario de elemento. |
| PREVIEWDISPLAY |
Se usa cuando se edita un formulario de presentación con Microsoft FrontPage. |
| PREVIEWNEW |
Se usa cuando se edita un nuevo formulario de elemento con FrontPage. |
| PREVIEWEDIT |
Se usa cuando se edita un formulario de elemento de edición con FrontPage. |
Ejemplos
El siguiente ejemplo muestra el uso del elemento SetVar para establecer el ámbito global para una variable. La segunda línea devuelve el valor establecido en la primera línea.
<SetVar Name="GlobalVar" Scope="Request">Value</SetVar>
...
<GetVar Name="GlobalVar">
En el ejemplo siguiente, el primer elemento GetVar devuelve Value_2 y el segundo elemento GetVar devuelve Value_1 porque el elemento SetVar que contiene Value_2 solo se aplica a los elementos secundarios del elemento Sample . Value_2 sale del ámbito después de la etiqueta de ejemplo de cierre.
<SetVar Name="myVar">Value_1</SetVar>
<Sample>
<SetVar Name="myVar">Value_2</SetVar>
<GetVar Name="myVar"/>
</Sample>
<GetVar Name="myVar"/>
En el ejemplo siguiente se evalúa si un campo es necesario y, si es necesario, crea el asterisco rojo (*) que se muestra junto a los campos obligatorios en formularios New o Edit y establece la variable HasRequired en 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>