数据定义元素
适用于: 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 数据库中数据时的行为,以及如何将数据发回数据库。 可为下列值之一:Text、Note、Number、Currency、Integer、Boolean、DateTime、Threading、Lookup、Choice、URL、Counter 或 DisplayOnly。 请注意,DisplayOnly 字段类型没有其自己的存储区。 |
名称 |
Text |
包含 Field 元素的 Type 属性中引用的内部数据类型的名称: <Field Type="Name"/> 。 例如,Text、Note、Number 等。 |
NewPattern |
注意 |
包含用于生成新表单以编辑字段的初始值的 HTML 模板。 |
PreviewDisplayPattern |
注意 |
指定在 Microsoft SharePoint Designer 中编辑显示窗体时如何呈现字段。 |
PreviewEditPattern |
注意 |
指定在 Microsoft SharePoint Designer 中编辑编辑表单时如何呈现字段。 |
PreviewNewPattern |
注意 |
指定在 Microsoft SharePoint Designer 中编辑新窗体时如何呈现字段。 |
可排序 |
Text |
指定是否可排序字段。 可以为 TRUE 或 FALSE。 |
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.xml 的 HeaderPattern 部分,以显示筛选器下拉菜单。 |
FieldPrefix |
返回 Microsoft Office 命名空间 urn:schemas-microsoft-com:office:office# 。 |
FieldRef |
用于计算字段以引用构成字段,还用于视图中以定义存在哪些字段。 |
FieldSortImageURL |
返回指向用于指示如何对列进行排序的图像文件的 URL。 |
FieldSortParams |
返回列表的排序方向,基于是否已排序字段以及当前默认排序方向来呈现 Asc 或 Desc。 |
IfEqual |
允许基于两个 CAML 表达式的比较结果进行条件呈现。 |
IfNew |
如果项被视为新项,则返回 TRUE。 |
ImagesPath |
返回项目的图像目录的 HTTP 路径。 |
限制 |
将文本截断为指定大小。 |
LocaleInfo |
将服务器区域设置信息传输到客户端,以便正确显示和编辑日期和数字。 |
PageUrl |
用于任何位置,以返回当前页的绝对、编码的 URL。 |
属性 |
从当前 ForEach 上下文返回属性。 |
ScriptQuote |
用于从服务器呈现必须解释为引用字符串的文本。 |
TodayISO |
以 ISO 格式呈现当前日期和时间。 |