Élément LookupColumn (View)

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

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>

Éléments et attributs

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

Attributs

Attribut Description
HTMLEncode
Boolean facultatif. TRUE pour convertir des caractères incorporés de façon à ce que qu'ils s'affichent en tant que 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
Facultatif Boolean.
Nom
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
Boolean facultatif. TRUE pour supprimer des espaces au début et à la 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, par exemple, %c3%ab pour 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 d’une URL et non pour encoder la barre oblique ( / ).

Éléments enfants

Aucun

Éléments parents

Nombreux

Occurrences

Remarques

Dans le cas d’un champ liste de recherche appelé LookupTitle qui pointe vers le titre de l’élément 1 dans une liste d’annonces, le rendu « Prise en main avec SharePoint Foundation! », tandis que le rendu « <LookupColumn Name="LookupTitle"/> <Column Name="LookupTitle"/> 1 ».

Par conséquent, dans la plupart des situations impliquant des champs de recherche, 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