Elemento GetVar (Vista)
Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
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>
Elementos y atributos
En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.
Atributos
| Atributo | Descripción |
|---|---|
| AutoHyperlink |
Boolean opcional. TRUE para rodear el texto con <A> etiquetas si el texto aparece como un hipervínculo, por ejemplo, www.microsoft.com. |
| AutoHyperLinkNoEncoding |
Boolean opcional. TRUE para rodear texto con <A> etiquetas si el texto aparece como un hipervínculo (por ejemplo, www.microsoft.com) pero sin codificación HTML. |
| AutoNewLine |
Boolean opcional. TRUE para insertar <BR> etiquetas en el flujo de texto y para reemplazar varios espacios por un espacio sin interrupció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 mediante el intérprete del Lenguaje de marcado de la aplicación de colaboración (CAML), lo que permite a CAML representar CAML. |
| HTMLEncode |
Boolean opcional. TRUE para convertir caracteres incrustados de manera 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. |
| Nombre |
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. TRUE para quitar el espacio en blanco al principio y al final del valor devuelto por el elemento. |
| URLEncode |
Boolean opcional. TRUE para convertir caracteres especiales, como espacios, en formato UTF-8 entre comillas, por ejemplo, %c3%ab para el carácter ë. |
| URLEncodeAsUrl |
Boolean opcional. Al igual que URLEncode, pero TRUE para especificar que la cadena que se va a codificar es un componente de ruta de acceso de una dirección URL para que las barras diagonales (/) no se codifican. |
Elementos secundarios
Ninguno
Elementos principales
Numerosos
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 los 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 Filter contiene 1, se muestra Ocultar opciones de filtro . Si no es así, la acción predeterminada implementa una segunda instrucción Switch que evalúa una segunda variable, FilterField1. Si el valor de FilterField1 es una cadena vacía, no se aplica ningún filtro y se muestra Filter en la barra de herramientas; De lo contrario, la acción predeterminada es mostrar Cambiar filtro.