Élément LookupColumn (View)

  • Article

S’applique à : | SharePoint 2016 SharePoint Foundation 2013 | | SharePoint Online 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
Facultatif Boolean. 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.
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
Texte facultatif. 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 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 entre guillemets, par exemple pour %c3%ab le caractère ë.
URLEncodeAsURL
Facultatif Boolean. Comme URLEncode, mais TRUE pour spécifier que la chaîne à encoder 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 De recherche appelé LookupTitle qui pointe vers le titre de l’élément 1 dans une liste d’annonces, <LookupColumn Name="LookupTitle"/> affiche « Prise en main de SharePoint Foundation ! », tandis que <Column Name="LookupTitle"/> « 1 ».

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