Elemento SetVar (Vista)
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>
Atributos
| Atributo | Descripción |
|---|---|
ID |
Text opcional. Proporciona un identificador para la variable. |
Name |
Text obligatorio. Especifica un nombre para la variable. |
Scope |
Si está establecido en Request, la variable es global. |
Value |
Text opcional. Puede usarse para asignar un valor a la variable cuando es un elemento vacío. |
Elementos secundarios
Ninguno |
Elementos primarios
Muchos |
Repeticiones
Mínimo: 0 Máximo: sin límite |
Comentarios
El elemento SetVar tiene una forma expandida y otra no expandida, por lo tanto, <SetVar Name="MyVar">Announcements</SetVar> sería lo mismo que <SetVar Name="MyVar" Value="Announcements/>.
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 |
|---|---|
DISPLAY |
Se usa cuando se representa la sección ViewBody de una vista. |
EDIT |
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. |
NEW |
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. |
Ejemplo
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 siguiente ejemplo, el primer elemento GetVar devuelve "Value_2", y el segundo elemento GetVar devuelve "Value_1", porque el elemento SetVar que contiene "Value_2" sólo se aplica a elementos secundarios del elemento "Sample". "Value_2" queda fuera de ámbito tras la etiqueta "Sample" de cierre.
<SetVar Name="myVar">Value_1</SetVar>
<Sample>
<SetVar Name="myVar">Value_2</SetVar>
<GetVar Name="myVar"/>
</Sample>
<GetVar Name="myVar"/>
El siguiente ejemplo evalúa si un campo es obligatorio y, en ese caso, crea el asterisco rojo (*) que se muestra junto a los campos obligatorios en los formularios nuevos o de edición 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>