LookupColumn, élément (View)

Article
09/24/2014

Dernière modification : jeudi 15 avril 2010

S’applique à : SharePoint Foundation 2010

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

Fonctions similaires à l'élément Column mais valide uniquement lorsque vous faites référence à un champ Lookup. La seule différence entre les éléments Column et LookupColumn des champs Lookup est que LookupColumn récupère la valeur brute de la colonne de la liste étrangère, tandis que Column récupère la valeur brute de la colonne dans la liste locale.

<LookupColumn
    HTMLEncode = "TRUE" | "FALSE"    IncludeVersions = "TRUE" | "FALSE" 
    Name = "Text"
    ShowField = "Text"
    StripWS = "TRUE" | "FALSE"
    URLEncode = "TRUE" | "FALSE"
    URLEncodeAsURL = "TRUE" | "FALSE">
</LookupColumn>

Attributs

Attribut	Description
HTMLEncode	Facultatif Boolean.TRUE pour convertir des caractères incorporés de façon à ce que qu'ils s'affichent sous forme de texte dans le navigateur. En d'autres termes, les caractères qui peuvent être confondus avec des balises HTML sont convertis en entités.
IncludeVersions	Boolean facultatif.
Name	Obligatoire Text. Spécifie le nom de la colonne de recherche. Permet à l'élément LookupColumn d'être utilisé en dehors du contexte de rendu de champ en fournissant un ID.
ShowField	Facultatif Text. Spécifie le champ à afficher dans la liste qui est référencée par le biais du champ Lookup. Si cet attribut n'est pas spécifié, la valeur par défaut qui s'affiche est celle contenue dans le champ Title.
StripWS	Facultatif Boolean. TRUE pour supprimer les espaces blancs de début et de fin de la valeur renvoyée par l'élément.
URLEncode	Facultatif Boolean.TRUE pour convertir des caractères spéciaux, tels que des espaces, au format UTF-8 entre guillemets, par exemple, %c3%ab par le caractère ë.
URLEncodeAsURL	Facultatif Boolean. Comme URLEncode, mais TRUE pour spécifier que la chaîne à coder est un composant de chemin d'accès à une URL et qu'elle n'est pas destinée à coder la barre oblique (« / »).

Éléments enfants

Aucun

Éléments parents

Nombreux

Occurrences

Minimum : 0

Maximum : pas de limite (1 dans Expr1,Expr2 et UrlBaseName)

Remarques

Dans le cas d’un champ Lookup appelé LookupTitle qui pointe vers le titre de l’élément 1 dans une liste des annonces, <LookupColumn Name="LookupTitle"/> doit rendre « Guide de mise en route de SharePoint Foundation » tandis que <Column Name="LookupTitle"/> doit rendre « 1 ». Par conséquent, dans la plupart des situations qui impliquent des champs Lookup utilisez l’élément LookupColumn au lieu de l’élément Column. L’élément Column s’utilise uniquement lorsque vous avez besoin d’une référence à l’ID de l’élément dans la liste cible, par exemple pour construire votre propre lien vers l’élément cible.

Exemple

Le code exemple suivant utilise l'élément LookupColumn pour renvoyer une valeur qui est utilisée lors de la création d'une URL complète d'une page sur le serveur.

<HTML><![CDATA[ <a href="  ]]></HTML>
<HttpHost URLEncodeAsURL="TRUE" />
<LookupColumn URLEncodeAsURL="TRUE" />
<HTML><![CDATA[ ">  ]]></HTML>

Voir aussi

Référence

Column, élément (View)

Partager via