office 365 Sharepoint 2013

平台环境： office 365 Sharepoint  2013

操作文件和文件夹 访问文档库的最佳方式是借助在 /_api/web 处可用的 GetFolderByServerRelativeUrl 方法。向文档库中添加文件时，需要在请求正文中发送文件内容，并在 URL 中传递文件的名称：

          http://<site url>/_api/web/GetFolderByServerRelativeUrl(
  '/Shared Documents')/Files/add(url='a.txt',overwrite=true)
        

更新文件时的一个重要注意事项是只能使用 PUT HTTP 方法。因此，无法将一个文件的内容合并到已存储在文档库中的文件中。这样做的结果是使用该文件的某个版本替换掉另一个。另外，请务必在 URL 中使用 $value 运算符，以便访问文件本身的内容，而非与该文件关联的元数据：

          http://<site url>/_api/web/GetFileByServerRelativeUrl(
  '/Shared Documents/a.txt')/$value
        

在对文件作出任意更改前将其签出是 SharePoint 中的一个最佳做法，因此，应该在更新文件前将其签出，并在完成操作后将其重新签回。下面的操作需要向这些 URL 发送 POST 请求（请求正文为空）：

          http://<site url>/_api/web/GetFileByServerRelativeUrl(
  '/Shared Documents/a.txt')/CheckOut()
http://<site url>/_api/web/GetFileByServerRelativeUrl(
  '/Shared Documents/a.txt')/CheckIn(comment='Comment', checkintype=0)
        

CheckIn 方法有两个参数。comment 参数的作用是向签入操作添加注释，checkintype 参数则用于指定此次操作为次要 (0) 还是主要 (1) 签入。

最后需要注意的一点是，如果使用的是在浏览器客户端中运行的代码（如 JavaScript），且需要上传大小超过 1.5MB 的文件，则 REST 是您的唯一选择。此类用于大文件（大小超过 1.5MB）的操作仅在 Internet Explorer 10（或更高版本）及其他同等优质的现代浏览器中可用。