Élément FieldRef (Query)

S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | SharePoint En ligne | SharePoint Server 2013

Représente une référence à un champ au sein d'une requête.

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

Éléments et attributs

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut Description
Alias
Texte facultatif.
Ascending
Valeur Boolean facultative. Ceci spécifie l'ordre de tri sur un élément FieldRef défini dans un affichage. La valeur par défaut est TRUE.
CreateURL
Valeur Text facultative. Spécifie l'URL du fichier .aspx utilisé pour créer un site d'espace de travail de réunion.
DisplayName
Valeur Text facultative. Cet attribut fournit le nom complet du champ référencé.
Explicit
Valeur Boolean facultative. Cet attribut est uniquement pris en charge dans l'élément ViewFields. Valeur TRUE si le champ est explicitement déclaré dans la définition de l'affichage et n'est pas retourné dans une énumération Fields à l'intérieur d'un affichage.
Format
Texte facultatif.
ID
Valeur Text facultative. Spécifie le GUID qui identifie le champ.
Clé
Valeur Text facultative. Si défini sur Primary, spécifie que le champ est la clé primaire de sa table et qu'il identifie par conséquent de manière unique chaque enregistrement de la table.
List
Texte facultatif. Spécifie la liste étrangère parente lorsque l’élément FieldRef est un enfant d’un élément Eq dans l’élément Join. La valeur est un alias de la liste définie par l’attribut ListAlias de l’élément Join.
LookupId
Facultatif Boolean. Lorsque le champ est de type Liste de recherche, spécifie que les requêtes doivent rechercher l’élément par son ID d’élément unique plutôt que par la valeur du champ. Cela peut être utile, par exemple, lorsque plusieurs éléments ont des valeurs identiques dans le champ et que vous souhaitez interroger un élément spécifique. La valeur par défaut est false.
Nom
Texte facultatif. Cet attribut fournit le nom interne du champ référencé.
RefType
Valeur Text facultative. Spécifie le type de référence d'un champ dans une liste d'événements.
ShowField
Valeur Text facultative. L'attribut ShowField peut être défini sur le nom de champ à afficher. Par défaut, un texte sous forme de lien hypertexte à partir du champ Titre de l'enregistrement dans la liste externe est affiché. Mais l'attribut ShowField peut être utilisé pour remplacer cela et afficher un autre champ à partir de la liste externe.
Les types de données suivants sont autorisés en tant que cibles d'un attribut ShowField : Text, Choice et Counter.
TextOnly
Valeur Boolean facultative. Spécifie que le champ ne contient que des valeurs de texte.
Type
Valeur Text facultative. Spécifie la fonction appliquée à une colonne de totaux ou une colonne calculée. Les valeurs possibles sont les suivantes :

AVG Valeur moyenne. S’applique aux types de champs DateTime Number, Integer et Currency.
COUNT Nombre d’éléments. S'applique à tous les types de champs qui autorisent l'agrégation.
MAX Valeur maximale. S’applique aux types de champs DateTime Number, Integer et Currency.
MIN Valeur minimale. S’applique aux types de champs DateTime Number, Integer et Currency.
SUM Somme des valeurs. S'applique aux types de champs Number, Integer et Currency.
STDEV Écart-type. S'applique aux types de champs Number, Integer et Currency.
VAR Variation. S'applique aux types de champs Number, Integer et Currency.

Les valeurs de l'attribut Type ne respectent pas la casse.

Éléments enfants

Aucun

Éléments parents

Occurrences

  • Minimum : 0
  • Maximum : 1 (sans limite dans OrderBy)

Exemples

L'exemple de requête suivante recherche les cas où le champ Date d'expiration a la valeur null ou contient une valeur supérieure ou égale à la date du jour.

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

Cet exemple du fichier Schema.xml contacts répertorie les champs à afficher dans la barre d’outils.

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