通过

ListTemplate 元素（列表模板）

上次修改时间： 2015年3月9日

适用范围： SharePoint Foundation 2010

本文内容
属性
子元素
父元素

指定可用作在"创建"页上创建列表的选项的列表定义。

<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"
  MultipleTypes = "TRUE" | "FALSE"
  MustSaveRootFiles = "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>

属性

属性

说明

AllowDeletion

可选属性，类型为 Boolean。如果为 TRUE，则指定无法删除通过模板创建的列表；否则为 FALSE。

AllowEveryoneViewItems

可选属性，类型为 Boolean。若要允许任何用户查看库中的项，则为 TRUE。例如，在母版页样式库中使用 AllowEveryoneViewItems 属性可为所有用户提供对母版页的访问权。

AlwaysIncludeContent

可选属性，类型为 Boolean。如果为 TRUE，则指定当通过模板创建的列表在用户界面中另存为列表模板时默认包括列表内容；否则为 FALSE。

BaseType

必需属性，类型为 Integer。为从定义创建的列表指定基本类型或默认架构。

  • 0 -- GenericList

  • 1 -- DocumentLibrary

  • 3 -- DiscussionBoard

  • 4 — Survey

  • 5 -- Issue

CacheSchema

可选属性，类型为 Boolean。若要在设置网站时启用列表的架构缓存，则为 TRUE。例如，在全局 Onet.xml 文件中使用 CacheSchema 属性可为当前网站集启用用户列表的缓存。

Catalog

可选属性，类型为 Boolean。如果为 TRUE，则指定列表定义用于网站库、列表库或 Web 部件库。

Category

可选属性，类型为 Text。指定要将通过列表定义创建的列表与其关联的类别。可能的值包括：

  • Libraries

  • Communications

  • Tracking

  • Custom Lists

Default

可选属性，类型为 Boolean。如果为 TRUE，则指定新的 SharePoint 网站将包括此列表。

Description

可选属性，类型为 Text。提供列表定义的说明。

DisableAttachments

可选属性，类型为 Boolean。如果为 TRUE，则指定用户可将文件附加到通过模板创建的列表中的项；否则为 FALSE。

DisallowContentTypes

可选属性，类型为 Boolean。如果为 TRUE，则指定无法在通过模板创建的列表上管理内容类型；否则为 FALSE。

DisplayName

必需属性，类型为 Text。指定列表定义的显示名称。

DocumentAsEnclosure

可选属性，类型为 Boolean。指定是否将文档作为外壳对象包括在列表中。

DocumentTemplate

可选属性，类型为 Integer。当前未使用。这只在其 BaseType 设置为 1（文档库）的 ListTemplate 元素中有效。考虑到未来兼容性，该属性应为空或对应于 DocumentTemplates 枚举中 DocumentTemplate 元素的 Type 属性。[与以前版本相同，但不推荐使用。]

DontSaveInTemplate

可选属性，类型为 Boolean。如果为 TRUE，则当列表通过用户界面另存为自定义列表模板或当列表所属的网站另存为自定义网站模板时排除列表的内容。

EditPage

可选属性，类型为 Text。指定自定义应用程序页的名称 (/_layouts)，该页用于编辑通过列表模板创建的列表的列表属性。

EnableModeration

可选属性，类型为 Boolean。如果为 TRUE，则指定默认在通过模板创建的列表中启用内容审批；否则为 FALSE。

EnablePeopleSelector

可选属性，类型为 Boolean。指定 EnablePeopleSelector 属性的值。

EnableResourceSelector

可选属性，类型为 Boolean。指定 EnableResourceSelector 属性的值。

FeatureId

可选属性，类型为 Text。指定用于标识与模板关联的功能 GUID。

FolderCreation

可选属性，类型为 Boolean。如果为 TRUE，则在列表中启用文件夹创建并指定"新建文件夹"命令显示在列表视图的"新建"菜单中；否则为 FALSE。

Hidden

可选属性，类型为 Boolean。如果为 TRUE，则指定"创建"页上没有用于创建列表的列表定义。

HiddenList

可选属性，类型为 Boolean。如果为 TRUE，则指定从列表定义创建的列表处于隐藏状态。

Image

可选属性，类型为 URL。指定指向用于表示列表的图标的 URL。

MultipleMtgDataList

可选属性，类型为 Boolean。如果指定 MultipleMtgDataList="TRUE"，则会议工作区网站中的列表包含网站内多个会议实例的数据。

MultipleTypes

可选属性，类型为 Boolean。指定是否存在多个列表类型。

MustSaveRootFiles

可选属性，类型为 Boolean。如果为 TRUE，则当在没有内容的情况下保存列表模板时，保存供会议工作区网站内部使用的特殊文档库中包含的页。此属性不是为公共使用而设计的。

Name

必需属性，类型为 Text。指定列表定义的内部名称。不能使用空格或特殊字符。此名称还用于查找包含用于定义正在使用的架构的 Schema.xml 文件的文件夹。

NewPage

可选属性，类型为 Text。指定自定义页的名称，该页用于通过列表模板创建新列表。

NoCrawl

可选属性，类型为 Boolean。如果为 TRUE，则指定搜索结果不包含列表；否则为 FALSE。

OnQuickLaunch

可选属性，类型为 Boolean。如果为 TRUE，则在"快速启动"栏中显示根据列表定义创建的列表。

Path

可选属性，类型为 Text。指定包含列表定义的网站定义的名称；例如，STS。假设此路径是 12\TEMPLATE 目录的相对路径。此路径可指向功能架构；例如，Features\Announcements。[与以前版本相同，但不推荐使用。]

RootWebOnly

可选属性，类型为 Boolean。如果为 TRUE，则指定从定义创建的列表仅存在于网站集的根网站中。[与以前版本相同，但不推荐使用。]

SecurityBits

可选属性，类型为 Text。为具有足够读取或编辑列表项权限的用户定义列表中的项目级权限。SecurityBits 属性包含一个 2 位数字的字符串。该字符串中的第一个数字控制读取权限；字符串中的第二个数字控制编辑权限。对于读取权限，有效的数字如下：

  • 1   用户可读取所有项。

  • 2   用户只能读取自己的项。

对于编辑权限，有效的数字如下：

  • 1   用户可编辑所有项。

  • 2   用户只能编辑自己的项。

  • 4   用户不能编辑项。

备注

无论 SecurityBits 属性的值为多少，具有 ManageLists 权限的用户均可读取和编辑所有项。

此属性不适用于文档库。

Sequence

可选属性，类型为 Integer。指定排序优先级，以供"创建"页上的列表模板使用。如果未设置 Sequence，则该模板显示在同样缺少 Sequence 值的任何其他模板的任意顺序的最后。指定相同序列的两个模板以任意顺序排序在一起。

SetupPath

可选属性，类型为 Text。指定 SharePoint Foundation 安装目录 (%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\\TEMPLATE) 中包含要包括在模板中的文件的文件夹的路径。

SyncType

可选属性，类型为 Boolean。若要重写与 SharePoint Foundation 基模板关联的默认客户端列表类型，则为 TRUE。

Type

可选属性，类型为 Integer。提供模板的唯一标识符。此标识符在功能内必须是唯一的，但不必在所有功能定义或网站定义中均是唯一的。要查看默认列表模板类型的列表，请参阅 SPListTemplateType。

此属性对应于 List 元素的 Type 属性。

Unique

可选属性，类型为 Boolean。如果为 TRUE，则指定列表定义或列表模板只能用于在网站创建期间创建列表，但不能用于在应用网站模板或定义后通过对象模型或用户界面创建列表。将此属性设置为 TRUE 将导致列表隐藏，这样它就不会作为一个选项显示在"创建"页上或"文档和列表"页上。

UseRootFolderForNavigation

可选属性，类型为 Boolean。若要指定"快速启动"中显示的列表的链接指向根文件夹，以便用户转到自定义欢迎页面，而不是转到默认的列表视图页，则为 TRUE。

备注

如果未为列表设置自定义欢迎 URL，则呈现一个指向根文件夹的链接，从而达到与链接到默认列表视图相同的效果。

VersioningEnabled

可选属性，类型为 Boolean。如果为 TRUE，则指定默认在通过模板创建的列表中启用版本控制；否则为 FALSE。

子元素

无

父元素

Elements

示例

有关如何使用此元素的示例，请参阅列表模板文件。