Compartilhar via


Elemento FieldRef (consulta)

Representa uma referência a um campo em uma consulta.

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

Atributos

Atributo Descrição

Alias

Opcional Text.

Ascending

Opcional Boolean. Especifica o ordem de classificação em um elemento FieldRef FieldRef que esteja definido em uma exibição. O valor usar como padrão é TRUE.

CreateURL

Opcional Text. Especifica o URL para o arquivo .aspx que é usado para criar um site Meeting Workspace.

DisplayName

Opcional Text. Esse atributo fornece o nome exibir do campo que está relacionado.

Explicit

Opcional Boolean. Esse atributo só é com suporte dentro de elemento ViewFields ViewFields. TRUE se o campo é explicitamente declarado na definição de exibição e não é retornadas em um Fields enumeração dentro uma exibição campos.

ID

Opcional Text. Especifica o GUID que identifica o campo.

Key

Opcional Text. Se definido como Primary, especifica que o campo é o chave primária para sua tabela e, portanto, identifica com exclusividade cada registro na tabela a.

Name

Necessário Text. Esse atributo fornece o nome interno do campo que está relacionado.

RefType

Opcional Text. Especifica o tipo de referência para um campo em uma lista Eventos.

ShowField

Opcional Text. O atributo ShowField ShowField pode ser definido como nome de campo para exibir. Por padrão, um texto de hiperlink a partir de campo de título do registro no externo lista é exibida. Mas o atributo ShowField ShowField pode ser usado para substituir esse e exibir outro campo a partir de externo lista.

O seguinte dados tipos permitidos como destinos de um atributo ShowField ShowField: TextChoice e Counter.

TextOnly

Opcional Boolean. Especifica que o campo contém somente valores de texto.

Type

Opcional Text. Especifica a função que for aplicada a uma coluna de totais ou uma coluna calculada. Valores possíveis incluem o seguinte:

  • AVG média. Applies to DateTimeNumber, Integer, and Currency field types.

  • COUNT Número de itens. Aplica-se a todos os tipos campo que permitem a agregação.

  • MAX valor máximo. Applies to DateTimeNumber, Integer, and Currency field types.

  • MIN mínimo. Applies to DateTimeNumber, Integer, and Currency field types.

  • SUM soma dos valores. Se aplica aos tipos campo de moeda Number, Integer e Currency.

  • STDEV desvio padrão. Se aplica aos tipos campo de moeda Number, Integer e Currency.

  • VAR variação. Se aplica aos tipos campo de moeda Number, Integer e Currency.

Os valores para o atributo Type tipo não são com diferenciação de maiúsculas e minúsculas.

Elementos filho

Nenhum

Elementos pai

BeginsWith, Contains, DateRangesOverlap, Eq, Geq, GroupBy, Gt, IsNotNull, IsNull, Leq, Lt, Neq, OrderBy

Ocorrências

No mínimo: 0

Máximo: 1 (Unbounded em ClassificadoPor)

Exemplo

O seguinte exemplo consultas para casos onde o campo de expiração é qualquer NULL null ou contém um valor maior ou igual de atual data.

                    <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>

O próximo exemplo do arquivo Schema.xml Schema.xml para listas de contatos especifica os campos para exibir na barra de ferramentas.

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