Column 元素（视图）
上次修改时间： 2015年3月9日
适用范围： SharePoint Foundation 2010
本文内容
属性
子元素
父元素
出现次数
返回特定字段的原始数据值，而不是由 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>
属性
属性 |
说明 |
|---|---|
AutoHyperLink |
可选属性，类型为 Boolean。如果为 TRUE，则在文本显示为超链接（例如，www.microsoft.com）时将文本包含在 <A> 标记内。 |
AutoHyperLinkNoEncoding |
可选属性，类型为 Boolean。如果为 TRUE，则在文本显示为超链接（例如，www.microsoft.com）但没有 HTML 编码时将文本包含在 <A> 标记内。 |
AutoNewLine |
可选属性，类型为 Boolean。如果为 TRUE，则将 <BR> 标记插入文本流并用不间断空格 ( ) 替换多个空格。 |
Default |
可选属性，类型为 Text。如果由选定项返回的值是一个空字符串 ("")，则呈现为此属性指定的文本。 |
Format |
可选属性，类型为 Text。控制日期字段的日期格式。支持的格式包括 DateTime、DateOnly、TimeOnly、ISO8601、ISO8601Basic 和 ISO8601Gregorian。 |
HTMLEncode |
可选属性，类型为 Boolean。如果为 TRUE，则转换嵌入的字符，以便这些字符作为文本显示在浏览器中。换句话说，就是将可能与 HTML 标记混淆的字符转换为实体。 |
Name |
可选属性，类型为 Text。通过提供 ID（例如 <Column Name="ID"/>），允许在字段呈现上下文外部使用 Column 元素。 |
ShowField |
可选属性，类型为 Text。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 设置为 Display。如果要从表单创建项，可将 DisplayMode 设置为 New。如果要编辑现有项，可将 DisplayMode 设置为 Edit。通过直接设置 DisplayMode 变量，可在页中替代该变量，例如 <SetVar Name="DisplayMode">Edit</SetVar>。
使用 <Column/> 呈现日期字段或数字字段时，将采用服务器的区域设置呈现数据，因为 <Column/> 可根据服务器的区域设置特定规则来呈现数值。