构建基块:文件和文档
上次修改时间: 2010年11月1日
适用范围: SharePoint Foundation 2010
本文内容
文件和文档的对象模型
用于文件和文档的 XML
与文件和文档相关的领域
有关文件和文档的详细信息
在 Microsoft SharePoint Foundation 上下文中,"文件"可能指与文档库中的列表项相关联的文档,也可能指提供用户界面的网站或应用程序 .aspx 页。有关网站页面和应用程序页面的信息,请参阅构建基块:网页和用户界面。
文档库中的每个文档都由一个 SPListItem 对象和一个 SPFile 对象表示。从文档库返回列表项时,可以使用 File 属性检索与该项目相关联的文件。SPFolder 类的 Files 属性返回文档库文件夹中的所有文件,而 SPWeb 的 Files 属性返回网站中使用的 .aspx 文件。返回特定文件夹的有效方式是使用网站的 GetFolder() 方法。
备注
请考虑,对于文档库来说,SPFolder 对象算是列表项,这与泛型列表相同。枚举文档库中的所有项目的代码可以使用列表项的 FileSystemObjectType 属性区分文件夹和文件。
若要将文件添加到文档库中,请使用 SPFileCollection 类的 Add() 方法之一。若要将文件从一个位置复制到网站中的另一位置或者在网站之间复制文件,请使用相关联列表项对象的 Copy() 方法。若要将网站页面或应用程序页面添加到网站,请使用模块功能设置文件。有关功能的信息,请参阅构建基块:功能。
文件和文档的对象模型
下面是在服务器和客户端对象模型中用于处理文件和文档的最重要的类:
SPFile - 表示 SharePoint Foundation 网站中的文件,该文件可以是 Web 部件页面、文档库中的项目或文件夹中的文件。
SPFolder - 表示 SharePoint Foundation 网站中的文件夹。
客户端对象模型:Folder(JavaScript:SP.Folder)
SPFileCollectionAddParameters - 封装可用于通过 Add(String, [], SPFileCollectionAddParameters) 方法或 Add(String, Stream, SPFileCollectionAddParameters) 方法向文件集添加文件的选项。
SPFileSaveBinaryParameters - 封装通过调用 SaveBinary(Stream, SPFileSaveBinaryParameters) 方法保存文件时可以使用的选项。
客户端对象模型:FileSaveBinaryInformation
SPFileStream - 围绕 SharePoint Foundation 文件公开 Stream 对象。
SPFileVersion - 表示文件对象的版本。
客户端对象模型:FileVersion(JavaScript:SP.FileVersion)
用于文件和文档的 XML
协作应用程序标记语言 (CAML) 中的 File 元素在 Module 元素中用来为网站设置网站或应用程序页面。File 元素可在网站定义 Configuration 元素的模块中用来在通过网站定义创建的网站中包含文件,也可以在功能的清单文件中使用 File 元素。有关可以使用此元素的两种方式的详细信息,请参阅模块。有关演示如何使用 File 元素为网站设置文件的示例,请参阅如何:设置文件。