LookupColumn 元素(视图)

上次修改时间: 2015年3月9日

适用范围: SharePoint Foundation 2010

本文内容
属性
子元素
父元素
出现次数

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>

属性

属性

说明

HTMLEncode

可选属性,类型为 Boolean。如果为 TRUE,则转换嵌入的字符,以便这些字符作为文本显示在浏览器中。换句话说,就是将可能与 HTML 标记混淆的字符转换为实体。

IncludeVersions

可选属性,类型为 Boolean。

Name

必需属性,类型为 Text。指定查找列的名称。允许 LookupColumn 元素通过提供 ID 而在字段呈现上下文之外使用。

ShowField

可选属性,类型为 Text。指定在列表(通过 Lookup 字段引用)中显示的字段。如果未指定此属性,则默认显示 Title 字段中的值。

StripWS

可选属性,类型为 Boolean。如果为 TRUE,则移除元素返回的值开头和末尾的空格。

URLEncode

可选属性,类型为 Boolean。如果为 TRUE,则将特殊字符(如空格)转换为引用的 UTF-8 格式(例如,%c3%ab 表示字符 ë)。

URLEncodeAsURL

可选属性,类型为 Boolean。与 URLEncode 类似,但如果为 TRUE,则指定要编码的字符串为 URL 的路径部分,以便不对左斜线("/")进行编码。

子元素

父元素

很多

出现次数

最小值:0

最大值:无限制(在 Expr1Expr2UrlBaseName 中为 1)

备注

对于指向通知列表中项目 1 的标题的 Lookup 字段(名为 LookupTitle),<LookupColumn Name="LookupTitle"/> 将呈现"Get Started with 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>

请参阅

引用

Column 元素(视图)