Elemento FieldRef (Consulta)
Ú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.
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>