Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

FieldRef, élément (Query)

Dernière modification :lundi 9 mars 2015

S’applique à :SharePoint Foundation 2013 | 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>

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

Facultatif Text.

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

Facultatif Text. Spécifie la liste étrangère parent lors de l'élément FieldRef est un enfant d'un élément Eq de participer à un élément. La valeur est un alias pour la liste définie par l'attribut ListAlias de l'élément à joindre .

LookupId

Facultatif Boolean. Lorsque le champ est un type de liste de choix, spécifie que les requêtes doivent se présenter pour cet élément par son unique ID d'élément plutôt que 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 pour un élément spécifique. La valeur par défaut est false.

Name

Facultatif Text. Cet attribut fournit le nom interne du champ qui est 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

Text facultatif. L'attribut ShowField peut prendre le nom du champ à afficher. Par défaut, un texte du lien hypertexte extrait du champ Titre de l'enregistrement de la liste externe est affiché. Cependant, l'attribut ShowField permet de se substituer à cette valeur et d'afficher un autre champ 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.

Minimum : 0

Maximum : 1 (illimité dans OrderBy)

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 extrait le fichier Schema.xml des listes de contacts 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>
Afficher: