FieldRef, élément (requête)

Article
09/24/2014

Dernière modification : mardi 22 juin 2010

S’applique à : SharePoint Foundation 2010

Dans cet article
Attributs
Éléments enfants
Éléments parents
Occurrences

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

Attributs

Attribut	Description
Alias	Valeur Text facultative.
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	Argument Text facultatif.
ID	Valeur Text facultative. Spécifie le GUID qui identifie le champ.
Key	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	Argument Text 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.
Name	Argument Text 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 DateTimeNumber, 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 DateTimeNumber, Integer et Currency. MIN Valeur minimale. S'applique aux types de champs DateTimeNumber, 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

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

Occurrences

Minimum : 0

Maximum : 1 (illimité dans OrderBy)

Exemple

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>

L’exemple suivant provenant du fichier Schema.xml pour les listes de contact spécifie 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>

Partager via