Elemento Coluna (Exibição)

Artigo
04/08/2023

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

Retorna o valor bruto de dados para um determinado campo, em oposição à versão formatada fornecida pelo elemento Field . No caso de um campo Pesquisa , Column retorna o valor local (um número de ID na lista que faz referência a outra lista), enquanto o elemento LookupColumn retorna os dados da tabela estrangeira.

<Column
  AutoHyperLink = "TRUE" | "FALSE"
  AutoHyperLinkNoEncoding = "TRUE" | "FALSE"
  AutoNewLine = "TRUE" | "FALSE"
    Default = "Text"
  Format="DateTime"
    HTMLEncode = "TRUE" | "FALSE"
    Name = "Text"
    ShowField = "Text"
    StripWS = "TRUE" | "FALSE"
  SubColumnNumber = Integer
    URLEncode = "TRUE" | "FALSE"
    URLEncodeAsURL = "TRUE" | "FALSE">
</Column>

Elementos e atributos

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

Atributos

Atributo	Descrição
AutoHyperLink	Booliano opcional. TRUE para cercar texto com `<A>` marcas se o texto aparecer como um hiperlink (por exemplo, `www.microsoft.com`).
AutoHyperLinkNoEncoding	Booliano opcional. TRUE para cercar texto com `<A>` marcas se o texto aparecer como um hiperlink (por exemplo, `www.microsoft.com`) mas sem codificação HTML.
AutoNewLine	Booliano opcional. TRUE para inserir `<BR>` marcas no fluxo de texto e substituir vários espaços por um espaço sem quebra (` `).
Padrão	Texto opcional. Renderiza o texto atribuído a esse atributo se o valor retornado por uma seleção for uma cadeia de caracteres vazia (`""`).
Format	Texto opcional. Controla a formatação de data para campos de data. Os formatos com suporte incluem DateTime, DateOnly, TimeOnly, ISO8601, ISO8601Basic e ISO8601Gregorian.
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.
Nome	Texto opcional. Permite que o elemento Column seja usado fora do contexto de renderização de campo fornecendo uma ID (por exemplo, `<Column Name="`ID`"/>`).
ShowField	Texto opcional. O atributo ShowField pode ser definido como o nome da coluna a ser exibido. Por padrão, um texto hiperlink da coluna Título do registro na lista externa é exibido. Mas o atributo ShowField pode ser usado para substituir isso e exibir outro campo da lista externa. Os seguintes tipos de dados são permitidos como destinos de um atributo ShowField : Texto, Escolha e Contador.
StripWS	Booliano opcional. TRUE para remover o espaço em branco do início e do final do valor retornado pelo elemento.
SubColumnNumber	Inteiro opcional.
Urlencode	Booliano opcional. TRUE para converter caracteres especiais, como espaços, para o formato UTF-8 citado (por exemplo, `%c3%ab` para 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 para que as barras de encaminhamento (`/`) não sejam codificadas.

Elementos filho

Nenhum

Elementos pai

Numerosos

Occurrences

Mínimo: 0
Máximo: desvinculado (1 dentro do limite)

Comentários

Observe que quando um elemento column vazio (<Column/>) é usado, ele é sensível à configuração atual da DisplayMode variável. O modo de exibição é definido implicitamente de acordo com o comando atual que está sendo usado.

Se uma exibição ou item estiver sendo exibido, DisplayMode será definido como Exibição. Se um item estiver sendo criado a partir de um formulário, DisplayMode será definido como Novo. Se um item existente estiver sendo editado, DisplayMode será definido como Editar. A DisplayMode variável pode ser substituída na página definindo-a diretamente, por exemplo, <SetVar Name="DisplayMode">Edit</SetVar>.

Usar <Column/> para renderizar um campo de data ou um campo de número renderizará os dados na localidade do servidor porque <Column/> renderiza valores numéricos de acordo com as regras específicas da localidade do servidor.

Compartilhar via