通过

LookupColumn 元素 (视图)

  • 项目

适用于： SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

与 Column 元素的作用相似，但只在与 Lookup 字段一起使用时才有效。 用于 Lookup 字段的 Column 元素和 LookupColumn 元素之间的唯一差别是 LookupColumn 从外部列表检索列的原始值，而 Column 从本地列表检索列的原始值。

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

元素和属性

下面各部分介绍了属性、子元素和父元素。

Attributes

属性 说明
HTMLEncode
可选属性，类型为 Boolean。 如果为 TRUE，则转换嵌入的字符，以便这些字符作为文本显示在浏览器中。 换句话说，就是将可能与 HTML 标记混淆的字符转换为实体。
IncludeVersions
可选属性，类型为 Boolean。
名称
必需属性，类型为 Text。 指定查找列的名称。 允许 LookupColumn 元素通过提供 ID 而在字段呈现上下文之外使用。
ShowField
可选 文本。 指定在列表（通过 Lookup 字段引用）中显示的字段。 如果未指定此属性，则默认显示 Title 字段中的值。
StripWS
可选属性，类型为 Boolean。 如果为 TRUE，则移除元素返回的值开头和末尾的空格。
URLEncode
可选属性，类型为 Boolean。 如果为 TRUE ，可将特殊字符（如空格）转换为带引号的 UTF-8 格式，例如字符 %c3%abë。
URLEncodeAsURL
可选属性，类型为 Boolean。 与 URLEncode 类似，但 为 TRUE 指定要编码的字符串是 URL 的路径组件，而不是对正斜杠 (/) 进行编码。

子元素

无

父元素

众多

出现次数

备注

如果名为 LookupTitle 的 查阅 字段指向公告列表中的项目 1 的标题， <LookupColumn Name="LookupTitle"/> 则会呈现“SharePoint Foundation 入门！”，同时 <Column Name="LookupTitle"/> 呈现“1”。

因此，在涉及 Lookup 字段的大多数情况下，请使用 LookupColumn 元素，而不要使用 Column 元素。 只有在您需要原始引用目标列表中的项目 ID 时（可能为了创建自己的目标项目链接），才使用 Column 元素。

示例

下面的示例使用 LookupColumn 元素返回用于为服务器上的页面创建完整 URL 的值。

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

另请参阅