List 元素（列表）
上次修改时间： 2015年3月9日
适用范围： SharePoint Foundation 2010
本文内容
属性
子元素
父元素
出现次数
包含列表定义的顶级元素。
<List
BaseType = "Integer" | "Text"
Default = "TRUE" | "FALSE"
DefaultItemOpen = "Integer"
Description = "Text"
Direction = "Text"
DisableAttachments = "TRUE" | "FALSE"
DraftVersionVisibility = "Integer"
EnableContentTypes = "TRUE" | "FALSE" EnableMinorVersions = "TRUE" | "FALSE" EnableThumbnails = "TRUE" | "FALSE"
EventSinkAssembly = "Text"
EventSinkClass = "Text"
EventSinkData = "Text"
FolderCreation = "TRUE" | "FALSE"
Id = "GUID"
ModeratedList = "TRUE" | "FALSE"
ModerationType = "TRUE" | "FALSE"
Name = "Text"
OrderedList = "TRUE" | "FALSE"
PrivateList = "TRUE" | "FALSE"
QuickLaunchUrl = "URL"
RootWebOnly = "TRUE" | "FALSE"
ThumbnailSize = "Integer"
Title = "Text"
Type = "Integer"
Url = "URL"
URLEncode = "TRUE" | "FALSE"
VersioningEnabled = "TRUE" | "FALSE"
WebImageHeight = "Integer"
WebImageWidth = "Integer">
</List>
属性
属性 |
说明 |
|---|---|
BaseType |
可选属性，类型为 Text。BaseType 属性可设置为 Integer（将值以整数形式存储）或 Text（默认，将值以文本形式存储）。请注意，无法创建整数基类型选择字段。 |
Default |
可选属性，类型为 Boolean。若要指定在创建网站时也创建在 Onet.xml 文件中引用的列表，则为 TRUE。否则将不会在创建网站时创建该列表，但可在后面的实例化中使用该列表。 |
DefaultItemOpen |
可选属性，类型为 Boolean。若要指定在列表中生成项目的服务器转换的应用程序在浏览器（而不是在单独的客户端应用程序中）中打开项目，则为 1；否则为 0。 |
Description |
可选属性，类型为 Text。提供列表的说明。向网站定义中添加自定义列表定义时，必须在 Onet.xml 文件的配置中指定此属性。此属性的值覆盖与 Schema.xml 文件的 DefaultDescription 元素包含在一起的值。 |
Direction |
必需属性，类型为 Text。指定列表的阅读顺序。可能的值包括 RTL（从右至左）、LTR（从左至右）或 none。 |
DisableAttachments |
可选属性，类型为 Boolean。如果为 TRUE，则在列表中禁用附件。 |
DraftVersionVisibility |
可选属性，类型为 Integer。指定查看草稿所需的权限。以下是可能的值：
|
EnableContentTypes |
可选属性，类型为 Boolean。如果为 TRUE，则在通过列表定义创建的列表中启用内容类型管理。 |
EnableMinorVersions |
可选属性，类型为 Boolean。 |
EnableThumbnails |
可选属性，类型为 Boolean。如果为 TRUE，则指定此列表中的文档分析程序生成缩略图文件，这些文件与保存到此列表的文档相对应。此属性仅适用于文档库。 |
EventSinkAssembly |
可选属性，类型为 Text。只为从 Windows SharePoint Services 2.0 升级的架构指定此选项。在为文档库事件提供事件处理程序的全局程序集缓存 (GAC) 中指定文件的强名称。例如，Microsoft.SharePoint, Version=11.0.0.0, Culture=Neutral, PublicKeyToken=71e9bce111e9429c。不推荐在 SharePoint Foundation 中使用此属性。 |
EventSinkClass |
可选属性，类型为 Text。以 Namespace_Name.Class_Name 格式指定类的区分大小写的完全限定名称，该类为文档库事件定义事件处理程序。不推荐在 SharePoint Foundation 中使用此属性。 |
EventSinkData |
可选属性，类型为 Text。包括文档库事件的事件处理程序使用的任意字符串。不推荐在 SharePoint Foundation 中使用此属性。 |
FolderCreation |
可选属性，类型为 Boolean。如果为 TRUE，则在"新建"菜单上显示"新建文件夹"命令。 |
Id |
可选属性，类型为 GUID。指定列表的 GUID。 |
ModeratedList |
可选属性，类型为 Boolean。如果为 TRUE，则要求对提交的项目进行内容审批。 |
ModerationType |
可选属性，类型为 Boolean。如果为 TRUE，则指定列表启用裁决，在创建或修改内容时需要审批过程。 |
Name |
必需属性，类型为 Text。列表的内部名称。 |
OrderedList |
可选属性，类型为 Boolean。如果为 TRUE，则指定可在列表的"编辑视图"页使用允许用户在列表中重新排列项目的选项。 |
PrivateList |
可选属性，类型为 Boolean。如果为 TRUE，则指定列表为专用列表。 |
QuickLaunchUrl |
可选属性，类型为 Text。指定要通过快速启动导航为列表打开的视图页的 URL。 |
RootWebOnly |
可选属性，类型为 Boolean。如果为 TRUE，则指定从定义创建的列表只存在于网站集的根网站中。 |
ThumbnailSize |
可选属性，类型为 Integer。指定在图片库中显示的缩略图的宽度。 |
Title |
必需属性，类型为 Text。列表的通用显示名称。 |
Type |
可选属性，类型为 Integer。指定列表的列表模板类型。以下值是默认列表模板类型。
此属性对应于 ListTemplate 元素的 Type 属性。 |
Url |
可选属性，类型为 Text。 指定与网站的根 URL 相对的、包含列表定义应用于的 ASPX 文件的根目录的路径。 |
URLEncode |
可选属性，类型为 Boolean。如果为 TRUE，则将特殊字符（如空格）转换为引用的 UTF-8 格式（例如，%c3%ab 表示字符 ë）。 |
VersioningEnabled |
可选属性，类型为 Boolean。如果为 TRUE，则在 Schema.xml 文件中指定为通过列表定义创建的文档库默认启用版本控制。设置此属性不会影响现有文档库。如果为 TRUE，则在创建库时仍然可以在"新建文档库"页上对文档库禁用版本控制。 |
WebImageHeight |
可选属性，类型为 Integer。指定图片库中图片的高度（以像素为单位）。 |
WebImageWidth |
可选属性，类型为 Integer。指定图片库中图片的宽度（以像素为单位）。 |
子元素
父元素
无 |
出现次数
最小值：0 最小值：1 |
备注
当用作列表架构文件的根元素时，List 元素必须包含 Microsoft SharePoint Foundationows: 命名空间声明。下面的行显示文档库中 Schema.xml 文件的开始部分：
<List
xmlns:ows="Microsoft SharePoint"
Name="Documents"
Title="$Resources:shareddocuments_Title;"
Direction="$Resources:Direction;"
Url="Shared Documents"
BaseType="1">
在列表架构中，MetaData 元素包含列表定义的不同部分。使用空 List 元素 (<List />) 可返回当前列表的标题。
在网站定义 (Onet.xml) 中，List 元素不包含 MetaData 节，但包含 Data 节，可通过 Data 节为给定的列表类型指定默认列值。