Elemento FieldRef (Consulta)

Artigo
04/08/2023

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

Representa uma referência a um campo dentro de uma consulta.

<FieldRef
  Alias = "Text"
  Ascending = "TRUE" | "FALSE"
  CreateURL = "Text"
  DisplayName = "Text"
  Explicit = "TRUE" | "FALSE"    Format = "Text"
  ID = "Text"
  Key = "Text"  List = "Text"
  LookupId = "TRUE" | "FALSE"
  Name = "Text"
  RefType = "Text"
  ShowField = "Text"
  TextOnly = "TRUE" | "FALSE"
  Type = "Text">
</FieldRef>

Elementos e atributos

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

Atributos

Atributo	Descrição
Alias	Texto opcional.
Ordem crescente	Booliano opcional. Isso especifica a ordem de classificação em um elemento FieldRef definido em uma exibição. O valor padrão é TRUE.
CreateURL	Texto opcional. Especifica a URL do arquivo .aspx usado para criar um site do Meeting Workspace.
DisplayName	Texto opcional. Esse atributo fornece o nome de exibição do campo referenciado.
Explicit	Booliano opcional. Esse atributo só tem suporte no elemento ViewFields . TRUE se o campo for declarado explicitamente na definição de exibição e não for retornado em uma enumeração Fields dentro de uma exibição.
Format	Texto opcional.
ID	Texto opcional. Especifica o GUID que identifica o campo.
Chave	Texto opcional. Se definido como Primário, especifica que o campo é a chave primária para sua tabela e, portanto, identifica exclusivamente cada registro na tabela.
List	Texto opcional. Especifica a lista estrangeira pai quando o elemento FieldRef é filho de um elemento Eq no elemento Join . O valor é um alias para a lista definida pelo atributo ListAlias do elemento Join .
Lookupid	Booliano opcional. Quando o campo é um tipo de Pesquisa, especifica que as consultas devem procurar o item por sua ID de item exclusivo em vez do valor de campo. Isso pode ser útil, por exemplo, quando vários itens têm valores idênticos no campo e você deseja consultar um item específico. O padrão é false.
Nome	Texto opcional. Esse atributo fornece o nome interno do campo referenciado.
Reftype	Texto opcional. Especifica o tipo de referência para um campo em uma lista de eventos.
ShowField	Texto opcional. O atributo ShowField pode ser definido como o nome do campo a ser exibido. Por padrão, um texto hiperlinkado do campo 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.
Textonly	Booliano opcional. Especifica que o campo contém apenas valores de texto.
Tipo	Texto opcional. Especifica a função que é aplicada a uma coluna total ou a uma coluna calculada. Os valores possíveis incluem o seguinte: AVG Valor médio. Aplica-se a tipos de campo DateTimeNumber, Integer e Conversor de Moedas. CONTAR Número de itens. Aplica-se a todos os tipos de campo que permitem agregação. MAX Valor máximo. Aplica-se a tipos de campo DateTimeNumber, Integer e Conversor de Moedas. MIN Valor mínimo. Aplica-se a tipos de campo DateTimeNumber, Integer e Conversor de Moedas. SOMA Soma de valores. Aplica-se a tipos de campo Número, Inteiro e Conversor de Moedas. STDEV Desvio padrão. Aplica-se a tipos de campo Número, Inteiro e Conversor de Moedas. VAR Variância. Aplica-se a tipos de campo Número, Inteiro e Conversor de Moedas. Os valores do atributo Type não são sensíveis a casos.

Elementos filho

Nenhum

Elementos pai

Occurrences

Mínimo: 0
Máximo: 1 (desvinculado no OrderBy)

Exemplos

O exemplo a seguir consulta casos em que o campo Expira é nulo ou contém um valor maior ou igual à data atual.

<Query>
   <Where>
      <Or>
         <IsNull>
            <FieldRef Name="Expires" />
         </IsNull>
         <Geq>
            <FieldRef Name="Expires" />
            <Value Type="DateTime">
               <Today />
            </Value>
         </Geq>
      </Or>
   </Where>
   <OrderBy>
      <FieldRef Name="Modified" Ascending="FALSE" />
   </OrderBy>
</Query>

Este exemplo do arquivoSchema.xml para contatos lista campos a serem exibidos na barra de ferramentas.

<ViewFields>
   <FieldRef Name="LinkTitleNoMenu"></FieldRef>
   <FieldRef Name="FirstName"></FieldRef>
   <FieldRef Name="WorkPhone"></FieldRef>
   <FieldRef Name="Email"></FieldRef>
</ViewFields>

Compartilhar via