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

 

以下是程序運行結果的截圖：