Elemento GetVar (Vista)
Última modificación: viernes, 30 de mayo de 2008
Hace referencia a: SharePoint Foundation 2010
En este artículo
Atributos
Elementos secundarios
Elementos primarios
Repeticiones
Devuelve una variable en el contexto de representación de la página. Las variables se pueden establecer localmente en el nivel actual de XML o globalmente en la página.
<GetVar
AutoHyperlink = "TRUE" | "FALSE"
AutoHyperLinkNoEncoding = "TRUE" | "FALSE"
AutoNewLine = "TRUE" | "FALSE"
Default = "TRUE" | "FALSE"
ExpandXML = "TRUE" | "FALSE"
HTMLEncode = "TRUE" | "FALSE"
Name = "Text"
Scope ="Request"
StripWS = "TRUE" | "FALSE"
URLEncode = "TRUE" | "FALSE"
URLEncodeAsURL = "TRUE" | "FALSE">
</GetVar>
Atributos
Atributo |
Descripción |
|---|---|
AutoHyperlink |
Boolean opcional. Es TRUE para rodear el texto con etiquetas <A> si el texto aparece como un hipervínculo, por ejemplo, www.microsoft.com. |
AutoHyperLinkNoEncoding |
Boolean opcional. Es TRUE para rodear el texto con etiquetas <A> si el texto aparece como un hipervínculo (por ejemplo, www.microsoft.com) pero sin codificación HTML. |
AutoNewLine |
Boolean opcional. Es TRUE para insertar etiquetas <BR> en la secuencia de texto y reemplazar varios espacios con un espacio de no separación ( ). |
Default |
Text opcional. Representa el texto asignado a este atributo si el valor devuelto por el atributo Select de otro elemento es una cadena vacía. |
ExpandXML |
Boolean opcional. Es TRUE para volver a pasar el contenido representado a través del intérprete del Lenguaje de marcado de la aplicación de colaboración (CAML), lo que permite a CAML representar CAML. |
HTMLEncode |
Boolean opcional. Es TRUE para convertir caracteres incrustados para que se muestren como texto en el explorador. En otras palabras, los caracteres que se podrían confundir con etiquetas HTML se convierten en entidades. |
Name |
Text obligatorio. El nombre de la variable. |
Scope |
Si se establece en Request, la variable está disponible globalmente en la página. |
StripWS |
Boolean opcional. Es TRUE para quitar espacios en blanco al principio y al final del valor devuelto por el elemento. |
URLEncode |
Boolean opcional. Es TRUE para convertir caracteres especiales, como espacios, en formato UTF-8 entrecomillado, por ejemplo %c3%ab para el carácter ë. |
URLEncodeAsUrl |
Boolean opcional. Igual que URLEncode, pero TRUE para especificar que la cadena que se va a codificar es un componente de la ruta de una dirección URL para que no se codifiquen las barras diagonales ("/"). |
Elementos secundarios
Ninguno |
Elementos primarios
Muchos |
Repeticiones
Mínimo: 0 Máximo: sin límite |
Comentarios
El elemento GetVar se usa a menudo dentro de elemento Expr de un elemento Switch o IfEqual.
Si se especifica Scope="Request" en el elemento SetVar, una asignación de la variable surtirá efecto en cualquier lugar de la página actual. De lo contrario, la asignación afecta sólo a elementos secundarios del elemento SetVar.
Ejemplo
En el siguiente ejemplo se usa el elemento GetVar para devolver información de filtrado actual para determinar el texto que se mostrará en la barra de herramientas que aparece encima de la lista.
<Switch>
<Expr>
<GetVar Name="Filter" />
</Expr>
<Case Value="1">
<HTML>Hide Filter Choices</HTML>
</Case>
<Default>
<Switch>
<Expr>
<GetVar Name="FilterField1" />
</Expr>
<Case Value="">
<HTML>Filter</HTML>
</Case>
<Default>
<HTML>Change Filter</HTML>
</Default>
</Switch>
</Default>
</Switch>
Si las opciones de filtro están abiertas en la lista y la variable de filtro contiene 1, se muestra "Ocultar opciones de filtrado". Si no, la acción predeterminada implementa una segunda instrucción Switch que se evalúa como una segunda variable, FilterField1. Si el valor de FilterField1 es una cadena vacía, no se aplica ningún filtro y se muestra "Filtro" en la barra de herramientas; en caso contrario, la acción predeterminada es mostrar "Cambiar filtro".