Elemento LookupColumn (Exibição)

Artigo
04/08/2023

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013

Funções semelhantes ao elemento Column , mas válidas somente ao se referir a um campo Pesquisa . A única distinção entre os elementos Column e LookupColumn para campos lookup é que LookupColumn recupera o valor bruto da coluna da lista estrangeira, enquanto Column recupera o valor bruto da coluna na lista local.

<LookupColumn
    HTMLEncode = "TRUE" | "FALSE"    IncludeVersions = "TRUE" | "FALSE"
    Name = "Text"
    ShowField = "Text"
    StripWS = "TRUE" | "FALSE"
    URLEncode = "TRUE" | "FALSE"
    URLEncodeAsURL = "TRUE" | "FALSE">
</LookupColumn>

Elementos e atributos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo	Descrição
Htmlencode	Booliano opcional. TRUE para converter caracteres inseridos para que eles sejam exibidos como texto no navegador. Em outras palavras, caracteres que podem ser confundidos com marcas HTML são convertidos em entidades.
IncludeVersions	Booliano opcional.
Nome	Texto obrigatório. Especifica o nome da coluna de pesquisa. Permite que o elemento LookupColumn seja usado fora do contexto de renderização de campo fornecendo uma ID.
ShowField	Texto opcional. Especifica o campo a ser exibido na lista referenciada por meio do campo Pesquisa . Se esse atributo não for especificado, o padrão será exibir o valor contido no campo Título .
StripWS	Booliano opcional. TRUE para remover o espaço em branco do início e do final do valor retornado pelo elemento.
Urlencode	Booliano opcional. TRUE para converter caracteres especiais, como espaços, no formato UTF-8 citado, por exemplo, `%c3%ab` para o caractere `ë`.
URLEncodeAsURL	Booliano opcional. Como URLEncode, mas TRUE para especificar que a cadeia de caracteres a ser codificada é um componente de caminho de uma URL e não para codificar a barra de encaminhamento (`/`).

Elementos filho

Nenhum

Elementos pai

Numerosos

Occurrences

Mínimo: 0
Máximo: Desvinculado (1 em Expr1, Expr2 e UrlBaseName)

Comentários

No caso de um campo lookup chamado LookupTitle que aponta para o título do item 1 em uma lista de anúncios, <LookupColumn Name="LookupTitle"/> renderizaria "Introdução ao SharePoint Foundation!", enquanto <Column Name="LookupTitle"/> renderizaria "1".

Consequentemente, na maioria das situações envolvendo campos de Pesquisa , use o elemento LookupColumn em vez do elemento Column . A única hora para usar o elemento Column é quando você precisa de uma referência bruta à ID do item na lista de destino, talvez para construir seu próprio link para o item de destino.

Exemplo

O exemplo a seguir usa o elemento LookupColumn para retornar um valor usado na criação de uma URL completa para uma página no servidor.

<HTML><![CDATA[ <a href="  ]]></HTML>
<HttpHost URLEncodeAsURL="TRUE" />
<LookupColumn URLEncodeAsURL="TRUE" />
<HTML><![CDATA[ ">  ]]></HTML>

Confira também

Elemento Coluna (Exibição)

Compartilhar via