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 最大值:无限制(在 Expr1、Expr2 和 UrlBaseName 中为 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>