Compartir a través de


Elemento FieldRef (Query)

Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Representa una referencia a un campo dentro de una 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 y atributos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo Descripción
Alias
Text opcional.
Orden ascendente
Boolean opcional. Especifica el criterio de ordenación en un elemento FieldRef que está definido en una vista. El valor predeterminado es TRUE.
CreateURL
Text opcional. Especifica la dirección URL del archivo .aspx usada para crear un sitio de área de reuniones.
DisplayName
Text opcional. Este atributo proporciona el nombre para mostrar del campo al que hace referencia.
Explicit
Boolean opcional. Este atributo sólo se admite dentro del elemento ViewFields. TRUE si el campo se declara explícitamente en la definición de la vista y no se devuelve en una enumeración de Fields dentro de una vista.
Format
Text opcional.
ID
Text opcional. Especifica el identificador GUID que identifica el campo.
Clave
Text opcional. Si se establece en Primary, especifica que el campo es la clave principal de su tabla y, por tanto, identifica de forma única cada registro de la tabla.
Lista
Text opcional. Especifica la lista externa primaria cuando el elemento FieldRef es un elemento secundario de un elemento Eq en el elemento Join . El valor es un alias para la lista definido por el atributo ListAlias del elemento Join .
LookupId
Boolean opcional. Cuando el campo es un tipo lookup, especifica que las consultas deben buscar el elemento por su identificador de elemento único en lugar del valor del campo. Esto puede ser útil, por ejemplo, cuando varios elementos tienen valores idénticos en el campo y desea consultar un elemento específico. El valor predeterminado es falso.
Nombre
Text opcional. Este atributo proporciona el nombre interno del campo al que hace referencia.
RefType
Text opcional. Especifica el tipo de referencia para un campo en una lista de eventos.
ShowField
Text opcional. El atributo ShowField se puede establecer en el campo del nombre que debe mostrarse. De forma predeterminada, se muestra un texto del hipervínculo desde el campo de título del registro en la lista externa. Sin embargo, el atributo ShowField se puede usar para invalidarlo y mostrar otro campo de la lista externa.
Los siguientes tipos de datos se permiten como destinos de un atributo ShowField: Text, Choice y Counter.
TextOnly
Boolean opcional. Especifica que el campo contiene sólo los valores de texto.
Tipo
Text opcional. Especifica la función que se aplica a una columna de totales o una columna calculada. A continuación se describen los valores posibles.

AVG Valor medio. Se aplica a los tipos de campo DateTimeNumber, Integer y Currency .
CONTAR Número de elementos. Se aplica a todos los tipos de campos que permiten la agregación.
MÁXIMO Valor máximo. Se aplica a los tipos de campo DateTimeNumber, Integer y Currency .
MIN Valor mínimo. Se aplica a los tipos de campo DateTimeNumber, Integer y Currency .
SUMA Suma de valores. Se aplica a los tipos de campo Number, Integer y Currency.
STDEV Desviación estándar. Se aplica a los tipos de campo Number, Integer y Currency.
VAR Varianza. Se aplica a los tipos de campo Number, Integer y Currency.

Los valores para el atributo Type no distinguen entre mayúsculas y minúsculas.

Elementos secundarios

Ninguno

Elementos principales

Repeticiones

  • Mínimo: 0
  • Máximo: 1 (sin enlazar dentro de OrderBy)

Ejemplos

En el siguiente ejemplo, se muestran consultas de casos en los que el valor del campo Expires es null o es mayor o igual que la fecha actual.

<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 ejemplo del archivo Schema.xml para los campos de listas de contactos que se mostrarán en la barra de herramientas.

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