Elemento FieldRef (Consulta)

Artículo
09/24/2014

Última modificación: martes, 22 de junio de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios
Apariciones

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"
  Name = "Text"
  RefType = "Text"
  ShowField = "Text"
  TextOnly = "TRUE" | "FALSE"
  Type = "Text">
</FieldRef>

Atributos

Atributo	Descripción
Alias	Text opcional.
Ascending	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.
Key	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.
List	Text opcional. Especifica la lista externa principal cuando el elemento FieldRef es un elemento secundario de un elemento Eq en el elemento Join. El valor es un alias para la lista que define el atributo ListAlias del elemento Join.
Name	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. Se pueden usar los siguientes tipos de datos como destinos de un atributo ShowField: Text, Choice y Counter.
TextOnly	Boolean opcional. Especifica que el campo contiene sólo los valores de texto.
Type	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 promedio. Se aplica a los tipos de campo DateTimeNumber, Integer y Currency. COUNT Número de elementos. Se aplica a todos los tipos de campos que permiten la agregación. MAX 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 . SUM 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 Variación. 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 primarios

BeginsWith, Contains, DateRangesOverlap, Eq, FieldRefs, Geq, GroupBy, Gt, In, Includes, IsNotNull, IsNull, Leq, Lt, Neq, NotIncludes, OrderBy

Apariciones

Mínimo: 0

Máximo: 1 (Sin límite en OrderBy)

Ejemplo

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>

En el ejemplo siguiente del archivo Schema.xml para listas de contactos, se especifican los campos que se deben mostrar en la barra de herramientas.

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