使用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         }

 

以下是程式運行結果的：