数据定义元素

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

协作应用程序标记语言 (CAML) 有两种主要类型的元素:用于页呈现的元素,以及用于字段呈现和架构定义的元素。 CAML 字段呈现元素在呈现单个字段值时使用。 这些值可以出现在字段类型定义中,更常见的是,显示在 FldTypes.xml\\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATES\XML

字段呈现和架构定义

字段是用户可添加到列表中的包含信息的列或属性。 基于 Microsoft SharePoint Foundation 的网站中的每个列表都有存储在数据库中的元数据。 架构的格式为 XML 结构,如下所示:

<Fields>
  <Field Type="Counter" Name="ID"/>
  ...other field definitions...
</Fields>

为了简化各种字段类型的实现过程以及允许更灵活地呈现各种字段,FldTypes.xml 包含有关每个字段类型的呈现和行为的信息。 Field 元素根据相关字段的数据类型的不同而呈现不同的 HTML,而 FldTypes.xml 定义数据类型以及每种字段的呈现模式。 下表列出了此文件中所用的架构。

名称 数据类型 说明
Column2Suffix
Text
包含要追加到基列名称的文本,用于从 ColumnName(用于两列字段,例如 URL)中派生 ColumnName2
DisplayPattern
注意
包含用于以视图或表单显示模式呈现字段的 HTML 模板。
EditPattern
注意
包含用于生成编辑表单控件以编辑字段的 HTML 模板。
HeaderPattern
注意
包含用于显示表视图列的标题的 HTML 模板。
InternalType
Text
确定 Column 元素在呈现 SharePoint Foundation 数据库中数据时的行为,以及如何将数据发回数据库。 可为下列值之一:TextNoteNumberCurrencyIntegerBooleanDateTimeThreadingLookupChoiceURLCounterDisplayOnly。 请注意,DisplayOnly 字段类型没有其自己的存储区。
名称
Text
包含 Field 元素的 Type 属性中引用的内部数据类型的名称: <Field Type="Name"/>。 例如,TextNoteNumber 等。
NewPattern
注意
包含用于生成新表单以编辑字段的初始值的 HTML 模板。
PreviewDisplayPattern
注意
指定在 Microsoft SharePoint Designer 中编辑显示窗体时如何呈现字段。
PreviewEditPattern
注意
指定在 Microsoft SharePoint Designer 中编辑编辑表单时如何呈现字段。
PreviewNewPattern
注意
指定在 Microsoft SharePoint Designer 中编辑新窗体时如何呈现字段。
可排序
Text
指定是否可排序字段。 可以为 TRUEFALSE
TypeName
Text
指定字段类型的定义中的名称。
SQLType
Text
确定给定字段的基础 SQL 数据类型。 示例包括 nvarchar (255) 、备注、整数、float。 用于生成相应的 SQL (CREATE TABLE) 来创建此类型的字段。
SQLType2
Text
当不为空白时,提供要为当前字段创建的另一列的类型(例如,请参阅 URL 字段类型)。

显示模式和显示模式

(显示编辑新建) 的每个显示模式都包含如何呈现 SharePoint Foundation 支持的每个字段数据类型的定义。

每个显示模式 (Mode) 均有一个显示模式 (Pattern) 或 CAML 呈现表达式。 某些 CAML 元素专门用于显示模式 (Pattern)。 其他 CAML 元素可用在任一上下文中,以用于页呈现或字段呈现,但是主要用于呈现字段。 以下内置 CAML 呈现元素用来构建可包括静态 HTML 和数据的模板以及所呈现字段的元数据。

元素 说明

返回特定字段的原始数据值。
Column2
用于呈现链接字段类型。
逃脱
用于转义字符串中的特定字符。
FieldFilterOptions
用于 FldTypes.xmlHeaderPattern 部分,以显示筛选器下拉菜单。
FieldPrefix
返回 Microsoft Office 命名空间 urn:schemas-microsoft-com:office:office#
FieldRef
用于计算字段以引用构成字段,还用于视图中以定义存在哪些字段。
FieldSortImageURL
返回指向用于指示如何对列进行排序的图像文件的 URL。
FieldSortParams
返回列表的排序方向,基于是否已排序字段以及当前默认排序方向来呈现 AscDesc
IfEqual
允许基于两个 CAML 表达式的比较结果进行条件呈现。
IfNew
如果项被视为新项,则返回 TRUE
ImagesPath
返回项目的图像目录的 HTTP 路径。
限制
将文本截断为指定大小。
LocaleInfo
将服务器区域设置信息传输到客户端,以便正确显示和编辑日期和数字。
PageUrl
用于任何位置,以返回当前页的绝对、编码的 URL。
属性
从当前 ForEach 上下文返回属性。
ScriptQuote
用于从服务器呈现必须解释为引用字符串的文本。
TodayISO
以 ISO 格式呈现当前日期和时间。

另请参阅