SPFile的使用

转:http://blog.csdn.net/pclzr/article/details/7591741

SPFile对应于SharePoint对象模型中的文件,它的使用方法与SPFolder类大致相似。在获取SPFile对象的时候,仍是通过SPFileCollection来进行,形式也与获取SPFolder相同。在SPWeb中,也同样提供了SPWeb.GetFile方法来获取一个文件。

· GetFile(string url):参数为该文件所在的url。

此外,对于文档库列表中的列表条目来说,也可以通过SPListItem.File来得到该文件的对象(关于文档库,稍候会进一步加以说明)。

在删除文件的时候,同样使用SPFile.Delete方法。

· Delete(string url):参数为待删除文件的url。

添加一个文件与添加文件夹稍有不同,需要指定文件的内容,并且有如下三种不同的形式。

· Add(string url, byte[] content):第一个参数指定待添加文件的url,第二个参数中以字节流的方式指定文件的内容。在指定文件url的时候,既可以使用完整的url(需要保证该目录存在),也可以只使用文件名(即添加到当前文件夹中)。使用该方法添加文件的时候,如果该url已经存在一个文件,则该函数会引发一个异常;

· Add(string url, byte[] content, bool overwrite):与上一种形式不同,这种形式通过第三个参数来指定当文件已存在时,是否进行覆盖。当overwrite为true时,会对重名的文件进行覆盖;否则,如果出现重名的情况,仍然会引发一个异常;

· Add(string url, byte[] content, SPUser createdBy, SPUser lastModifiedBy, DateTime timeCreated, DateTime timeLastModified):添加文件的时候,根据后4个参数,指定文件的创建者、修改者、创建时间、修改时间。但是在使用这种形式的时候需要注意,该程序的执行者必须为网站的管理员,而且该形式只有在WSS网站上有效(在SPS网站上,该方法会产生一个“Access
Denied”错误)。

以上三种方法在创建成功之后均会直接返回一个SPFile类型的对象。

SPFile类中一些属性及其含义如下,这些属性一律为只读的。

· Author:文件的创建者,是一个SPUser类的对象(关于该类,会在下一节中进行说明);

· CheckedOutBy:文档库的文件允许进行签入和签出的操作,该属性为签出的用户;

· CheckedOutDate:文件签出的时间;

· CheckedInComment:文件签入时的评论内容;

· CheckOutExpires:文件签出的过期时间;

· CheckOutStatus:文件签出的状态,

· Exists:该文件是否存在;

· IconUrl:SharePoint为每种常用类型的文件都提供了图标,该属性中保存了该图标的图像文件的文件名(并非完整的url),这些图片一般保存在“_layouts/images/”目录下;

· InDocumentLibrary:表示该文件是否在文档库中;

· Item:如果该文件在文档库中,那么该属性(SPListItem类)获取该文件在该文档库列表中的列表条目对象;

· Length:文件的大小(以字节为单位);

· ModifiedBy:该文件的最后修改者;

· Name:该文件的文件名;

· ParentFolder:该文件所在的目录对象;

· Properties:一个Hashtable型的对象,包括该文件的一些常用属性(例如创建者、创建时间、修改者、修改时间、文件大小、文件的版本等信息);

· ServerRelativeUrl:该文件相对于服务器根地址的url;

· TimeCreated:文件创建的时间;

· TimeLastModified:文件最后修改的时间;

· Url:该文件相对于其所在网站的地址;

· Versions:SPFileVersionCollection类的对象,SharePoint的文档库可以支持文档的版本管理和控制,该属性中保存了该文件自创建以来的各个版本,同时保存了各版本的信息。(由于篇幅所限,不再一一列举SPFileVersion类的属性,有兴趣的读者请参考SDK。)

SPFile类中也同样提供了一些方法。

· CheckIn():将文件签入文档库;

· CheckOut():将文件从文档库中签出;

· CopyTo(string newUrl):将文件复制到一个新的url地址中;

· CopyTo(string newUrl, bool overwrite):将文件复制到新的url地址中,并指定是否覆盖同名文件;

· MoveTo(string newUrl):将文件移动到一个新的地址中;

· MoveTo(string newUrl, bool overwrite):将文件移动到一个新的地址中,并指定是否覆盖同名文件;

· OpenBinary():以byte[]的形式返回该文件的内容;

· SaveBinary(byte[] content):以参数为内容,保存该文件。

示例9-8】 该示例中演示了从本地上传文件到文档库的过程:

// 首先获取到SPWeb对象web

SPFolder folder = web.GetFolder("Shared Documents");

if(folder.Exists)

{

FileStream fs = new FileStream(@"C:\Demo.txt", FileMode.Open);

byte[] content = new byte[fs.Length];

fs.Read(content, 0, (int)fs.Length);

folder.Files.Add("Demo.txt", content);

fs.Close();

}

else

Console.WriteLine("Folder Not Exist!");

该程序中的FileStream类和FileMode枚举是在System.IO命名空间中

上一篇:Spark SQL概念学习系列之Spark SQL 架构分析(四)


下一篇:SWIFT推送之本地推送(UILocalNotification)之二带按钮的消息