• 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):与上一种形式不同,这种形式通过第三个参数来指定当文件已存在时,是否进行覆盖。当overwritetrue时,会对重名的文件进行覆盖;否则,如果出现重名的情况,仍然会引发一个异常;

    · 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:该文件相对于其所在网站的地址;

    · VersionsSPFileVersionCollection类的对象,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命名空间中

  • 相关阅读:
    Visual Studio 2008 菜单:工具+选项+文本编辑器+HTML+格式,选中“键入时插入属性值引号”
    itemarray的意思
    SQL技巧大全
    IIS调用com组件的权限问题
    网站快速备案法(1小时)
    ASP.NET 2.0中WEB应用程序的部署
    c#中MessageBox的使用
    推荐一款DataGridView的打印解决方案
    使用C#格式化字符串
    关于MSSQL导入导出时主键与约束丢失的问题解决
  • 原文地址:https://www.cnblogs.com/jackljf/p/4768651.html
Copyright © 2020-2023  润新知