É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
- Minimum : 0
- Maximum : pas de limite (1 dans Expr1,Expr2 et UrlBaseName)
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>