列元素 (视图)
适用于: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013
返回特定字段的原始数据值,而不是由 Field 元素提供的格式化版本。 对于 Lookup 字段,Column 返回本地值(引用其他列表的列表中的 ID 号),而 LookupColumn 元素返回外表中的数据。
<Column
AutoHyperLink = "TRUE" | "FALSE"
AutoHyperLinkNoEncoding = "TRUE" | "FALSE"
AutoNewLine = "TRUE" | "FALSE"
Default = "Text"
Format="DateTime"
HTMLEncode = "TRUE" | "FALSE"
Name = "Text"
ShowField = "Text"
StripWS = "TRUE" | "FALSE"
SubColumnNumber = Integer
URLEncode = "TRUE" | "FALSE"
URLEncodeAsURL = "TRUE" | "FALSE">
</Column>
元素和属性
下面各部分介绍了属性、子元素和父元素。
Attributes
属性 | 说明 |
---|---|
AutoHyperLink |
可选属性,类型为 Boolean。 如果 文本显示为超链接 (,则为 TRUE, <A> 以标记将文本括起来, www.microsoft.com 例如,) 。 |
AutoHyperLinkNoEncoding |
可选属性,类型为 Boolean。 如果文本显示为超链接 ((例如 www.microsoft.com ,) 但没有 HTML 编码),则为 TRUE,将文本与<A> 标记括起来。 |
AutoNewLine |
可选属性,类型为 Boolean。 如果为 TRUE ,则在文本流中插入 <BR> 标记,并将多个空格替换为非中断空格 ( ) 。 |
默认 |
可选 文本。 如果选定内容返回的值是空字符串 () "" ,则呈现分配给此属性的文本。 |
Format |
可选属性,类型为 Text。 控制日期字段的日期格式。 支持的格式包括 DateTime、DateOnly、TimeOnly、ISO8601、ISO8601Basic 和 ISO8601Gregorian。 |
HTMLEncode |
可选属性,类型为 Boolean。 如果为 TRUE,则转换嵌入的字符,以便这些字符作为文本显示在浏览器中。 换句话说,就是将可能与 HTML 标记混淆的字符转换为实体。 |
名称 |
可选 文本。 通过提供 ID (例如"/> <Column Name=" ID) ,允许在字段呈现上下文外部使用 Column 元素。 |
ShowField |
可选 文本。 ShowField 属性可设置为要显示的列名称。 默认情况下,显示外部列表中记录的 Title 列中的超链接文本。 但可以使用 ShowField 属性替代该文本并显示外部列表中的另一个字段。 允许将下面的数据类型作为 ShowField 属性的目标:Text、Choice 和 Counter。 |
StripWS |
可选属性,类型为 Boolean。 如果为 TRUE,则移除元素返回的值开头和末尾的空格。 |
SubColumnNumber |
可选属性,类型为 Integer。 |
URLEncode |
可选属性,类型为 Boolean。 如果为 TRUE ,可将特殊字符(如空格)转换为带引号的 UTF-8 格式 (例如 %c3%ab 字符 ë ) 。 |
URLEncodeAsURL |
可选属性,类型为 Boolean。 与 URLEncode 类似,但 为 TRUE ,指定要编码的字符串是 URL 的路径组件,以便不编码 (/ ) 的正斜杠。 |
子元素
无
父元素
众多
出现次数
- 最少:0 次
- 最大值: 无限制(在 Limit 中为 1)
备注
请注意,当使用空 Column 元素 (<Column/>
) 时,该元素对变量的 DisplayMode
当前设置很敏感。 可根据要使用的当前命令隐式设置显示模式。
如果正在显示视图或项, DisplayMode
则 设置为 “显示”。 如果正在从窗体创建项, DisplayMode
则 设置为 “新建”。 如果正在编辑现有项, DisplayMode
则 设置为 “编辑”。 DisplayMode
通过直接设置变量,可以在页面中重写该变量,例如 <SetVar Name="DisplayMode">Edit</SetVar>
。
使用 <Column/>
呈现日期字段或数字字段将在服务器的区域设置中呈现数据,因为 <Column/>
根据服务器的区域设置特定规则呈现数值。