Elemento LookupColumn (Vista)
Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
Funciona de forma similar al elemento Column, pero sólo es válido cuando hace referencia a un campo Lookup. La única diferencia entre los elementos Column y LookupColumn para los campos Lookup es que LookupColumn recupera el valor sin formato de la columna de la lista externa, mientras que Column recupera el valor sin formato de la columna de la lista local.
<LookupColumn
HTMLEncode = "TRUE" | "FALSE" IncludeVersions = "TRUE" | "FALSE"
Name = "Text"
ShowField = "Text"
StripWS = "TRUE" | "FALSE"
URLEncode = "TRUE" | "FALSE"
URLEncodeAsURL = "TRUE" | "FALSE">
</LookupColumn>
Elementos y atributos
En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.
Atributos
| Atributo | Descripción |
|---|---|
| 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. |
| IncludeVersions |
Boolean opcional. |
| Nombre |
Text obligatorio. Especifica el nombre de la columna de búsqueda. Permite usar el elemento LookupColumn fuera del campo y representa el contexto proporcionando un identificador. |
| ShowField |
Text opcional. Especifica el campo que se va a mostrar en la lista al que se hace referencia en el campo Lookup. Si no se especifica este atributo, el valor predeterminado es mostrar el valor contenido en el campo Title. |
| 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 y no para codificar la barra diagonal (/). |
Elementos secundarios
Ninguno
Elementos principales
Numerosos
Repeticiones
- Mínimo: 0
- Máximo: sin límite (1 en Expr1, Expr2 y UrlBaseName)
Comentarios
En el caso de un campo de búsqueda denominado LookupTitle que apunta al título del elemento 1 de una lista de anuncios, <LookupColumn Name="LookupTitle"/> representaría "Get Started with SharePoint Foundation!", mientras que <Column Name="LookupTitle"/> representaría "1".
Por lo tanto, en la mayoría de las situaciones que implican campos Lookup , use el elemento LookupColumn en lugar del elemento Column . La única ocasión para usar el elemento Column es cuando se necesita una referencia sin formato al identificador del elemento en la lista de destino, quizás para construir su propio vínculo al elemento de destino.
Ejemplo
El siguiente ejemplo usa el elemento LookupColumn para devolver un valor que sirve para crear una dirección URL completa para una página en el servidor
<HTML><![CDATA[ <a href=" ]]></HTML>
<HttpHost URLEncodeAsURL="TRUE" />
<LookupColumn URLEncodeAsURL="TRUE" />
<HTML><![CDATA[ "> ]]></HTML>