Elemento LookupColumn (Vista)
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"
Name = "Text"
ShowField = "Text"
StripWS = "TRUE" | "FALSE"
URLEncode = "TRUE" | "FALSE"
URLEncodeAsURL = "TRUE" | "FALSE">
</LookupColumn>
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. |
Name |
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, al formato UTF-8 entre comillas, por ejemplo, %c3%ab para el carácter ë. |
URLEncodeAsURL |
Boolean opcional. Similar a URLEncode, pero TRUE para especificar que la cadena que se va a codificar es un componente de la ruta de acceso de una dirección URL y no sirve para codificar la barra diagonal ("/"). |
Elementos secundarios
Ninguno |
Elementos primarios
Muchos |
Repeticiones
Mínimo: 0 Máximo: sin límite (1 en Expr1, Expr2 y UrlBaseName) |
Comentarios
En el caso de un campo Lookup denominado LookupTitle que señale al título del elemento 1 en una lista de anuncios, <LookupColumn Name="LookupTitle"/> representaría "Get Started with Windows SharePoint Services!", 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>