使用C#利用Http协议从远端向SharePoint文档库上传文件

概述：

在程序中如何向SharePoint文档库上传文件是最普通的编程任务，实起来，有2种方式：

一、这项功能实现起来最方便的就是利用服务器OM，在程序中直接引用SharePoint.dll，里面有很多关于SharePoint的对象，程序可能直接通过对象的属性和方法来控制服务器内SharePoint的内容的变化，这种方式在SDK内有绍。

二、第二种就是程序运在客户端的，没有办法使用OM，因为SharePoint文档库支持Http协议的PUT方法，我们可以直接使用PUT这个方法，通过HTTP的字节流向其上传文档，本博就是介绍这种更普遍的方法。

此外，在2010版以后的SharePoint，我们可以使用Client Object的模型，从客户机来运行Client对象模型直接操作SharePoint服务器对象。

 

主要技术：

WebRequest: .Net Framework 中有一种类型，叫：WebRequest，其有一个静态方法用于创建基于某个URL请求对象：见如下代码：

WebRequest req = WebRequest.Create(destUri);

可以通过这个类，向远程WEB服务器发出各种请求；如果这个请求为GET，那么实现的功能就是从HTTP服务器中下载文件，如果这个请求为PUT，实现的功能就是从HTTP服务器上传文件。 可以通过设置这个类中的Method属性来设置请求的类型，如下：

req.Method = "PUT";

req.Headers.Add("Overwrite", "T");

第二行代码把这个PUT功能设置成允许覆盖，这是通过添加HTTP请求的头部来完成的，读者有兴趣可以参看互联网中关于HTTP的协议PUT功能的描述。

因为SharePoint文档库一般都需要特定的用户进行访问，所以一定有验证，这个类和其它网络类一样支持Credentials代码如下：

req.Credentials = new NetworkCredential("zhangyan", "********", "DomainName");

如何发出请求呢？，我们可以直接获得这个对象的流，然后向这个流写入文件的内容，就可以了。

Stream outStream = req.GetRequestStream();  

关于如何从文件中获得内容，并向这个流写入与本文无关，读者可以参考其它文章，代码如下：

System.IO.FileInfo myfile = new System.IO.FileInfo(localFilePath);
byte[] fileContentBytes = new byte[int.Parse(myfile.Length.ToString())];
FileStream fsv = File.OpenRead(localFilePath);
int nv = fsv.Read(fileContentBytes, 0, int.Parse(myfile.Length.ToString()));

 

代码说明：

本代码，包装成了一个方法即函数，UploadFile有2个参数，

说明：上传本地的一个文件至SharePoint文档库
destUrl参数说明：目标URL，比如http://www.domain.com/Shared Documents/Filename.txt</param>
localFilePath参数说明：本地文件路径,比如：C:\Filename.txt</param>
返回值：OK表示上传成功，否则返回错误文本

UploadFile(string destUrl, string localFilePath)

引用的DLL文件：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.IO;
using System.Net;

 

 

源代码：

 

 

 1  public  static  string UploadFile( string destUrl,  string localFilePath)
 2         {
 3              try
 4             {
 5                 System.IO.FileInfo myfile =  new System.IO.FileInfo(localFilePath);
 6                  byte[] fileContentBytes =  new  byte[ int.Parse(myfile.Length.ToString())];
 7                 FileStream fsv = File.OpenRead(localFilePath);
 8                  int nv = fsv.Read(fileContentBytes,  0,  int.Parse(myfile.Length.ToString()));
 9                 Uri destUri =  new Uri(destUrl);
10 
11                 MemoryStream inStream =  new MemoryStream(fileContentBytes);
12                 WebRequest req = WebRequest.Create(destUri);
13                 req.Method =  " PUT "; req.Headers.Add( " Overwrite ",  " T ");
14                 req.Timeout = System.Threading.Timeout.Infinite;
15                 req.Credentials =  new NetworkCredential( " 登录用户名 ",  " 密码 ",  " 域 ");
16                 Stream outStream = req.GetRequestStream();
17                  byte[] buffer =  new  byte[ 1024];
18                  while ( true)
19                 {
20                      int numBytesRead = inStream.Read(buffer,  0, buffer.Length);
21                      if (numBytesRead <=  0)
22                          break;
23                     outStream.Write(buffer,  0, numBytesRead);
24                 }
25                 inStream.Close();
26                 outStream.Close();
27                 WebResponse ores = req.GetResponse();
28                  return  " OK ";
29                 
30 
31             }
32 
33              catch (System.Exception ee)
34             {
35                  return ee.Message;
36             }
37         }

 

代码测试：

启动Visual Studio 2010，建立一个终端应用程序ConsoleApplication，把以上代码复制进去，然后在Main()函数中，输入以下代码：

 

1  static  void Main( string[] args)
2         {
3              string localFile =  " C:\\filename.txt ";
4              string destUrl =  http://您的SharePoint网站地址/SiteCollectionDocuments/filename.txt ;
5             Console.WriteLine( " Upload:  " + localFile +  "  To:  " + destUrl);
6             Console.WriteLine(UploadFile(destUrl, localFile));
7             Console.ReadLine();
8 
9         }

 

以下是程序运行结果的截图：