ListTemplate 元素 (网站)
适用于： SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013
指定一个列表定义，可用作创建“创建页面”上的列表的选项。
<ListTemplate
AllowDeletion = "TRUE" | "FALSE"
AllowEveryoneViewItems = "TRUE" | "FALSE"
AlwaysIncludeContent = "TRUE" | "FALSE"
BaseType = "0" | "1" |"3" | "4" | "5"
CacheSchema = "TRUE" | "FALSE"
Catalog = "TRUE" | "FALSE"
Category = "Libraries" | "Communications" | "Tracking" |
"Custom Lists"
Default = "TRUE" | "FALSE"
Description = "Text"
DisableAttachments = "TRUE" | "FALSE"
DisallowContentTypes = "TRUE" | "FALSE"
DisplayName = "Text" DocumentAsEnclosure = "TRUE" | "FALSE"
DocumentTemplate = "Integer"
DontSaveInTemplate = "TRUE" | "FALSE"
EditPage = "Text"
EnableModeration = "TRUE" | "FALSE" EnablePeopleSelector = "TRUE" | "FALSE" EnableResourceSelector = "TRUE" | "FALSE"
FeatureId = "Text"
FolderCreation = "TRUE" | "FALSE"
Hidden = "TRUE" | "FALSE"
HiddenList = "TRUE" | "FALSE"
Image = "URL"
MultipleMtgDataList = "TRUE" | "FALSE"
MustSaveRootFiles = "TRUE" | "FALSE" MultipleTypes = "TRUE" | "FALSE"
Name = "Text"
NewPage = "Text"
NoCrawl = "TRUE" | "FALSE"
OnQuickLaunch = "TRUE" | "FALSE"
Path = "Text"
RootWebOnly = "TRUE" | "FALSE"
SecurityBits = "Text"
Sequence = "Integer"
SetupPath = "Text"
SyncType = "Text"
Type = "Integer"
Unique = "TRUE" | "FALSE"
UseRootFolderForNavigation = "TRUE" | "FALSE"
VersioningEnabled = "TRUE" | "FALSE">
</ListTemplate>
元素和属性
下面各部分介绍了属性、子元素和父元素。
Attributes
| 属性 | 说明 |
|---|---|
| AllowDeletion |
可选属性，类型为 Boolean。 若要指定通过列表定义创建的列表无法删除，则为 TRUE；否则为 FALSE。 |
| AllowEveryoneViewItems |
可选属性，类型为 Boolean。 若要允许任何用户查看库中的项，则为 TRUE。 例如，在母版页样式库中使用 AllowEveryoneViewItems 属性可为所有用户提供对母版页的访问权。 |
| AlwaysIncludeContent |
可选属性，类型为 Boolean。 若要指定将在通过列表定义创建列表时默认包含的列表内容保存为用户界面中的列表模板，则为 TRUE；否则为 FALSE。 |
| BaseType |
必需属性，类型为 Integer。 为从定义创建的列表指定基本类型或默认架构。 在 SharePoint Foundation 中，这可以是 0、1、3、4 或 5。 不能为 2。 |
| CacheSchema |
可选属性，类型为 Boolean。 若要在设置网站时启用列表的架构缓存，则为 TRUE。 例如，在全局 Onet.xml 文件中使用 CacheSchema 属性可为当前网站集启用用户列表的缓存。 |
| 目录 |
可选属性，类型为 Boolean。 如果为 TRUE ，则指定列表定义适用于网站库、列表库或 Web 部件库。 |
| 类别 |
可选属性，类型为 Text。 指定要将通过列表定义创建的列表与其关联的类别。 可能的值包括： 库 通信 Tracking 自定义列表 |
| 默认 |
可选属性，类型为 Boolean。 如果为 TRUE，则指定新的 SharePoint 网站将包括此列表。 |
| 说明 |
可选属性，类型为 Text。 提供列表定义的说明。 |
| DisableAttachments |
可选属性，类型为 Boolean。 若要指定用户可以将文件附加到通过列表定义创建的列表，则为 TRUE；否则为 FALSE。 |
| DisallowContentTypes |
可选属性，类型为 Boolean。 若要指定可以在通过列表定义创建的列表上管理内容类型，则为 TRUE；否则为 FALSE。 |
| DisplayName |
必需属性，类型为 Text。 指定列表定义的显示名称。 |
| DocumentAsEnclosure |
可选属性，类型为 Boolean。 |
| DocumentTemplate |
可选属性，类型为 Integer。 当前未使用。 此属性仅在其 BaseType 设置为 1 的 ListTemplate 元素（文档库）中有效。 为了将来实现兼容，此属性应保留为空或对应于 DocumentTemplates 枚举中的 DocumentTemplate 元素的 Type 属性。 此属性已在 SharePoint Foundation 中弃用。 |
| DontSaveInTemplate |
可选属性，类型为 Boolean。 如果为 TRUE，则当列表通过用户界面另存为自定义列表模板或当列表所属的网站另存为自定义网站模板时排除列表的内容。 |
| EditPage |
可选属性，类型为 Text。 指定要用作页面的自定义表单的名称，该页面用于编辑通过列表定义创建的列表中的项。 |
| EnableModeration |
可选属性，类型为 Boolean。 若要指定在通过列表定义创建的列表中默认启用内容审批，则为 TRUE；否则为 FALSE。 |
| EnablePeopleSelector |
可选属性，类型为 Boolean。 |
| EnableResourceSelector |
可选属性，类型为 Boolean。 |
| FeatureId |
可选属性，类型为 Text。 指定标识与列表定义关联的功能的 GUID。 |
| FolderCreation |
可选属性，类型为 Boolean。 如果为 TRUE ，则启用列表内的文件夹创建，并指定“ 新建文件夹” 命令显示在列表视图中的“ 新建 ”菜单上;否则为 FALSE。 |
| Hidden |
可选属性，类型为 Boolean。 如果为 TRUE ，则指定列表定义在 创建列表的创建页上 不可用。 |
| HiddenList |
可选属性，类型为 Boolean。 如果为 TRUE，则指定从列表定义创建的列表处于隐藏状态。 |
| 图像 |
可选属性，类型为 URL。 指定指向用于表示列表的图标的 URL。 |
| MultipleMtgDataList |
可选属性，类型为 Boolean。 如果指定 MultipleMtgDataList="TRUE"，则会议工作区网站中的列表包含网站内多个会议实例的数据。 |
| MultipleTypes |
可选属性，类型为 Boolean。 |
| MustSaveRootFiles |
可选属性，类型为 Boolean。 如果为 TRUE，则当在没有内容的情况下保存列表模板时，保存供会议工作区网站内部使用的特殊文档库中包含的页。 此属性不是为公共使用而设计的。 |
| 名称 |
必需属性，类型为 Text。 指定列表定义的内部名称。 不能使用空格或特殊字符。 此名称还用于查找包含用于定义正在使用的架构的 Schema.xml 文件的文件夹。 |
| NewPage |
可选属性，类型为 Text。 指定要用作页面的自定义表单的名称，该页面用于创建通过列表定义创建的列表中的项。 |
| NoCrawl |
可选属性，类型为 Boolean。 如果为 TRUE，则指定搜索结果不包含列表；否则为 FALSE。 |
| OnQuickLaunch |
可选属性，类型为 Boolean。 如果 快速启动栏具有“列表”节点，则为 TRUE，则显示从 快速启动 栏上的列表定义创建的列表。 |
| 路径 |
可选 文本。 指定包含列表定义的网站定义的名称（例如，STS）。 假定此路径与 12\TEMPLATE 目录有关。 可以在功能架构中直接指向此路径（例如，Features\Announcements）。 此属性已在 SharePoint Foundation 中弃用。 |
| RootWebOnly |
可选属性，类型为 Boolean。 如果为 TRUE ，则指定从定义创建的列表仅存在于网站集的根网站中。 此属性已在 SharePoint Foundation 中弃用。 |
| SecurityBits |
可选属性，类型为 Text。 为具有足够读取或编辑列表项权限的用户定义列表中的项目级权限。 SecurityBits 属性包含一个两位数字符串。 此字符串中的第一个数字控制读取访问，同时字符串中的第二个数字控制编辑访问。 对于读取访问，存在以下有效数字： 1 用户可以读取所有项。 2 用户只能读取自己的项目。 对于编辑权限，有效的数字如下： 1 用户可以编辑所有项目。 2 用户只能编辑自己的项目。 4 用户无法编辑项目。 注意：无论 SecurityBits 属性值如何，具有 ManageLists 权限的用户都可以读取和编辑所有项。 此属性不适用于文档库。 |
| Sequence |
可选属性，类型为 Integer。 在“创建”页上指定使用列表定义的优先顺序。 如果未设置 Sequence，最后将按照任意顺序显示此列表定义和同样缺少 Sequence 值的任何其他列表定义。 将按照任意顺序对指定同一序列的两个列表定义排列在一起。 |
| SetupPath |
可选 文本。 指定 SharePoint Foundation 安装目录中文件夹的路径， ( \\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE 包含要包含在列表定义中的文件的) 。 |
| SyncType |
可选属性，类型为 Boolean。 如果为 TRUE ，则替代与 SharePoint Foundation 基模板关联的默认客户端列表类型。 |
| 类型 |
可选属性，类型为 Integer。 提供列表定义的唯一标识符。 此标识符在功能内必须是唯一的，但在所有功能定义或网站定义中不必是唯一的。 默认情况下，SharePoint Foundation 包含以下列表类型。 100 泛型列表 101 文档库 102 调查 103 链接列表 104 公告列表 105 联系人列表 106 事件列表 107 任务列表 108 讨论板 109 图片库 110 数据源 111 网站模板库 112 用户信息列表 113 Web 部件库 114 列表模板库 115 XML 表单库 116 个母版页库 117 No-Code工作流 118 自定义工作流流程 119 Wiki 页面库 120 列表的自定义网格 130 数据连接库 140 工作流历史记录 150 甘特任务列表 200 会议系列列表 201 会议议程列表 202 会议与会者列表 204 会议决策列表 207 会议目标列表 210 会议文本框 211 会议要带物品列表 212 会议工作区页面列表 301 博客文章列表 302 博客评论列表 303 博客类别列表 1100 问题跟踪 1200 管理员任务列表 对于自定义列表模板，此属性应设置为一个大于 10000 的数字以确保该模板不会与任何当前或将来的 Microsoft 提供的列表类型发生冲突。 此属性对应于 List 元素的 Type 属性。 |
| Unique |
可选属性，类型为 Boolean。 若要指定列表定义或列表模板只可以用于在网站创建过程中创建列表，并且不能用于在应用网站模板或定义之后通过对象模型或用户界面创建列表，则为 TRUE。 将此属性设置为 TRUE 可隐藏列表，使其不显示为 “创建页 ”或“ 文档和列表” 页上的选项。 |
| UseRootFolderForNavigation |
可选属性，类型为 Boolean。 如果为 TRUE ，则指定 快速启动 中显示的列表链接指向根文件夹，以便用户转到自定义欢迎页，而不是默认列表视图页。 注意：如果未为列表设置自定义欢迎 URL，则呈现指向根文件夹的链接在功能上等同于链接到默认列表视图。 |
| VersioningEnabled |
可选属性，类型为 Boolean。 若要指定在通过列表定义创建的列表中默认启用版本控制，则为 TRUE；否则为 FALSE。 |
子元素
无
父元素
出现次数
- 最小值：0
- 最大值：无限制
备注
在 SharePoint Foundation 中，标准 SharePoint 列表的列表模板通常在包含列表定义的功能的元素清单文件中定义。 有关列表模板功能的详细信息，请参阅 列出模板文件。