构造块:列表和文档库
上次修改时间: 2010年4月8日
适用范围: SharePoint Foundation 2010
本文内容
列表和文档库的对象模型
用于列表和文档库的 XML
与列表和文档库相关的领域
有关列表和文档库的详细信息
Microsoft SharePoint Foundation 2010 提供了几个可用于处理列表的 API。下面的托管对象模型提供了可用于修改列表属性以及创建和管理列表模板及列表项的类型和成员:
对于在服务器上运行的代码,Microsoft.SharePoint 命名空间提供了表示列表的核心类。Microsoft.SharePoint.Deployment 命名空间提供了用于在网站集之间迁移内容的 API。
对于在客户端 Microsoft .NET 3.5 应用程序或 Silverlight 应用程序上下文中运行的托管代码,Microsoft.SharePoint.Client 命名空间提供了一组可在服务器对象模型中使用的类型和成员。
对于在浏览器中运行的脚本,SP 命名空间的 ECMAScript(JavaScript、JScript) 对象模型提供了一组可在服务器对象模型中使用的类型和成员。
Lists Web 服务提供了远程处理列表的方法。
您可以在服务器端对象模型中使用 SaveAsTemplate(String, String, String, Boolean) 方法将现有 SharePoint Foundation 列表保存为列表模板,或者使用 SPListTemplate 类及其集合类来管理列表模板。SPListTemplate 类表示自定义列表模板和列表定义,前者可以通过 SaveAsTemplate(String, String, String, Boolean) 方法创建或通过 UI 保存,后者可以在 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES 目录中作为功能进行安装并激活。
列表架构具有基类型和列表模板类型。SPBaseType 枚举可识别以下列表基类型:
大多数列表的泛型列表类型
文档库
讨论板
调查
问题
未指定的基类型。
SPListTemplateType 枚举可识别 SharePoint Foundation 中的默认列表模板类型,其中每种均与单个列表基类型定义相关联。SPList 类提供对所有列表共有的列表属性的访问权,但列表模板类型也可以派生自列表基类型。例如,您可以将表示文档库的列表对象转换为 SPDocumentLibrary 对象,以访问特定于文档库的属性。
Microsoft Microsoft Business Connectivity Services (BCS) 提供了用于处理外部列表的 API。有关 Business Connectivity Services 的信息,请参阅构建基块:外部内容类型和外部列表。
列表和文档库的对象模型
服务器和客户端对象模型中的以下类可用于处理列表、列表模板和列表项:
SPList – 表示 SharePoint 网站上的列表。返回特定列表的高效方法是通过 SPWeb 或 SPListCollection 的 GetList 方法。
SPListDataSource – 提供有关外部列表的信息。
客户端对象模型:ListDataSource (JavaScript: ListDataSource)
SPListEventProperties – 提供 SharePoint 列表事件的属性。
SPListEventReceiver – 提供捕获列表事件的方法。
SPListItem – 表示列表中的项或行。返回列表项或 SPListItemCollection 的高效方法是通过 SPList 或 SPWeb 的 GetItem* 方法。
SPListItemVersion – 表示列表项的版本。
SPListTemplate – 表示列表定义或列表模板,它定义列表的字段和视图。列表定义包含在 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES 目录内的文件中,但列表模板是通过用户界面或通过对象模型将列表保存为模板时创建的。
客户端对象模型:ListTemplate (JavaScript: ListTemplate)
SPListTemplateType – 一种指定列表定义或列表模板的类型的枚举。
客户端对象模型:ListTemplateType (JavaScript: ListTemplateType)
SPBaseType – 一种指定列表的基类型的枚举。
SPDocTemplate – 表示文档库中使用的文档模板。
SPDocumentLibrary – 表示 SharePoint Foundation 中的文档库。
有关在服务器对象模型中处理列表的信息,请参阅使用列表对象和集合和基本对象模型任务中包含的编程任务。有关在客户端对象模型中处理列表的信息,请参阅数据检索概述和常见编程任务中的编程任务。
用于列表和文档库的 XML
列表定义作为 SharePoint Foundation 功能激活,并且具有一个包含架构的 Schema.xml 文件,但大多数视图定义是通过 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS\XSL 目录中的 XSLT 提供的。List 是列表架构中的顶层元素,而网站定义架构中的 Configuration 元素也包含 List 元素,以便包括特定列表作为通过网站定义创建的网站的一部分。列表实例功能允许您指定用于设置列表类型的默认数据。有关如何使用功能的信息,请参阅使用功能。有关演示如何创建列表定义功能的示例,请参阅如何:创建自定义列表定义。