ProjectedFields, élément (View)

Article
09/24/2014

Dernière modification : vendredi 15 octobre 2010

S’applique à : SharePoint Foundation 2010

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

Spécifie les champs dans des listes jointes qui peuvent être inclus dans l’affichage lorsqu’une ou plusieurs autres listes ont été jointes dans une requête.

<ProjectedFields>   
  <Field ... />  
  <Field ... />
</ProjectedFields>

Attributs

Aucun

Éléments enfants

Field

Notes

Il existe un nombre maximal d’éléments enfants Field. Ce nombre correspond à la différence entre le nombre maximal de champs autorisés dans la liste et le nombre de champs se trouvant déjà dans celle-ci.

Éléments parents

View

Occurrences

Notes

L’élément View ne peut pas posséder d’élément ProjectedFields sauf s’il possède un élément Joins qui détient au moins un élément enfant Join. Toutefois, un élément ProjectedFields qui forme la valeur d’une propriété SPQuery.ProjectedFields et qui, par conséquent, n’est pas un enfant d’un élément View, peut être utilisé pour prendre en charge une jointure implicite sans élément Joins. Il est déconseillé de ne pas utiliser un élément Joins. Le fait d’utiliser systématiquement un élément Join explicite permet d’optimiser la probabilité que votre solution soit compatible avec les versions futures de Microsoft SharePoint Foundation. Pour plus d’informations sur les jointures implicites avec des éléments ProjectedFields, voir Jointures de listes et projections.

Minimum : 0

Maximum : 1

Remarques

Si un champ d’une liste jointe n’est pas représenté dans ProjectedFields, il ne peut pas être inclus dans l’élément ViewFields.

Exemple

L’exemple suivant montre comment ajouter un champ aux résultats retournés par la requête. La valeur de l’attribut List est un alias de la liste étrangère. L’alias est défini dans un Élément Join (Afficher). L’attribut ShowField doit être défini sur le nom interne du champ étranger.

L’attribut Type n’indique pas le type des données du champ comme il le fait généralement dans un élément Field. Quand un élément Field est un enfant de l’élément ProjectedFields, Type indique simplement si l’élément Join (dans l’élément Joins sur lequel dépend l’élément ProjectedFields) repose sur une relation de recherche existante entre les listes. À partir de SharePoint Foundation 2010, toutes les jointures doivent reposer sur une relation de recherche existante, si bien que Type possède toujours la valeur « Recherche ». Le type de données réel du champ n’est pas indiqué lorsqu’il s’agit d’un enfant de l’élément ProjectedFields. Toutefois, le type de données du champ revêt de l’importance, car seuls les types de champs suivants peuvent être inclus dans un élément ProjectedFields :

Calculé (considéré comme du texte brut)
ContentTypeId
Compteur
Devise
Date et heure
Guid
Entier
Note (une seule ligne)
Nombre
Texte

<ProjectedFields>
  <Field
    Name=’CustomerCity’
    Type=’Lookup’
    List=’customerCities’
    ShowField=’Title’ />
</ProjectedFields>

Pour un exemple d’élément ProjectedFields dont l’élément Field enfant possède un attribut FieldRef au lieu d’un attribut List, voir Jointures de listes et projections.

Partager via