淺析C# FTP WebRequest對(duì)象
C# FTP WebRequest對(duì)象介紹
微軟的.NET framework 2.0相對(duì)于1.x來(lái)說(shuō)增加了對(duì)FTP的支持。以前為了符合我的需求,我不等不使用第三方類庫(kù)來(lái)實(shí)現(xiàn)FTP功能,但是為了可靠,還是使用.NET framework的類比較好。我的這段代碼沒有做成可重復(fù)使用的類庫(kù)的形式,但它卻是比較容易理解的并能滿足你的需求。它可以實(shí)現(xiàn)上傳,下載,刪除等任意功能。在這篇文章的后面將給大家出示.NET 2.0下實(shí)現(xiàn)FTP的簡(jiǎn)單代碼,使用的語(yǔ)言是c#?;蛟S是因?yàn)檫@是.NET新增的類,又或許是第三方類庫(kù)已經(jīng)能很好的實(shí)現(xiàn)你的需求,.NET 2.0的這部分類庫(kù)并沒有得到足夠的關(guān)注。
背景
作為我的工作的一部分,我已經(jīng)使用了FTP模塊,但是我只能在.NET 1.1中去使用它,所以我不能深入的研究.NET 2.0下FTP的實(shí)現(xiàn)。但是我相信,.NET 2.0下對(duì)FTP的支持是非常好的。
代碼
不要忘記引入命名空間
using System.NET;
using System.IO;
下面的幾個(gè)步驟包括了使用FTP WebRequest類實(shí)現(xiàn)FTP功能的一般過程
1、創(chuàng)建一個(gè)FTP WebRequest對(duì)象,指向FTP服務(wù)器的uri
2、設(shè)置FTP的執(zhí)行方法(上傳,下載等)
3、給FTP WebRequest對(duì)象設(shè)置屬性(是否支持ssl,是否使用二進(jìn)制傳輸?shù)龋?BR>4、設(shè)置登錄驗(yàn)證(用戶名,密碼)
5、執(zhí)行請(qǐng)求
6、接收相應(yīng)流(如果需要的話)
7、如果沒有打開的流,則關(guān)閉FTP請(qǐng)求
開發(fā)任何FTP應(yīng)用程序都需要一個(gè)相關(guān)的FTP服務(wù)器及它的配置信息。FTP WebRequest暴露了一些屬性來(lái)設(shè)置這些信息。
接下來(lái)的代碼示例了上傳功能,首先設(shè)置一個(gè)uri地址,包括路徑和文件名。這個(gè)uri被使用在FTP WebRequest實(shí)例中。
然后根據(jù)FTP請(qǐng)求設(shè)置C# FTP WebRequest對(duì)象的屬性
其中一些重要的屬性如下:
◆Credentials - 指定登錄FTP服務(wù)器的用戶名和密碼。
◆KeepAlive - 指定連接是應(yīng)該關(guān)閉還是在請(qǐng)求完成之后關(guān)閉,默認(rèn)為true
◆UseBinary - 指定文件傳輸?shù)念愋?。有兩種文件傳輸模式,一種是Binary,另一種是ASCII。兩種方法在傳輸時(shí),字節(jié)的第8位是不同的。ASCII使用第8位作為錯(cuò)誤控制,而Binary的8位都是有意義的。所以當(dāng)你使用ASCII傳輸時(shí)要小心一些。簡(jiǎn)單的說(shuō),如果能用記事本讀和寫的文件用ASCII傳輸就是安全的,而其他的則必須使用Binary模式。當(dāng)然使用Binary模式發(fā)送ASCII文件也是非常好的。
◆UsePassive - 指定使用主動(dòng)模式還是被動(dòng)模式。早先所有客戶端都使用主動(dòng)模式,而且工作的很好,而現(xiàn)在因?yàn)榭蛻舳朔阑饓Φ拇嬖冢瑢?huì)關(guān)閉一些端口,這樣主動(dòng)模式將會(huì)失敗。在這種情況下就要使用被動(dòng)模式,但是一些端口也可能被服務(wù)器的防火墻封掉。不過因?yàn)镕TP服務(wù)器需要它的FTP服務(wù)連接到一定數(shù)量的客戶端,所以他們總是支持被動(dòng)模式的。這就是我們?yōu)槭裁匆褂帽粍?dòng)模式的原意,為了確保數(shù)據(jù)可以正確的傳輸,使用被動(dòng)模式要明顯優(yōu)于主動(dòng)模式。(譯者注:主動(dòng)(PORT)模式建立數(shù)據(jù)傳輸通道是由服務(wù)器端發(fā)起的,服務(wù)器使用20端口連接客戶端的某一個(gè)大于1024的端口;在被動(dòng)(PASV)模式中,數(shù)據(jù)傳輸?shù)耐ǖ赖慕⑹怯蒄TP客戶端發(fā)起的,他使用一個(gè)大于1024的端口連接服務(wù)器的1024以上的某一個(gè)端口)
◆ContentLength - 設(shè)置這個(gè)屬性對(duì)于FTP服務(wù)器是有用的,但是客戶端不使用它,因?yàn)镕TP WebRequest忽略這個(gè)屬性,所以在這種情況下,該屬性是無(wú)效的。但是如果我們?cè)O(shè)置了這個(gè)屬性,F(xiàn)TP服務(wù)器將會(huì)提前預(yù)知文件的大小(在upload時(shí)會(huì)有這種情況)
◆Method - 指定當(dāng)前請(qǐng)求是什么命令(upload,download,filelist等)。這個(gè)值定義在結(jié)構(gòu)體WebRequestMethods.FTP中。以上介紹C# FTP WebRequest對(duì)象。
- private void Upload(string filename){
- FileInfo fileInf = new FileInfo(filename);
- string uri = "ftp://" + ftpServerIP + "/" + fileInf.Name;
- FtpWebRequest reqFTP;
- // 根據(jù)uri創(chuàng)建FtpWebRequest對(duì)象
- reqFTP = (FtpWebRequest)FtpWebRequest.Create(new Uri
("ftp://" + ftpServerIP + "/" + fileInf.Name));- // ftp用戶名和密碼
- reqFTP.Credentials = new NetworkCredential(ftpUserID, ftpPassword);
- // 默認(rèn)為true,連接不會(huì)被關(guān)閉
- // 在一個(gè)命令之后被執(zhí)行
- reqFTP.KeepAlive = false;
- // 指定執(zhí)行什么命令
- reqFTP.Method = WebRequestMethods.Ftp.UploadFile;
- // 指定數(shù)據(jù)傳輸類型
- reqFTP.UseBinary = true;
- // 上傳文件時(shí)通知服務(wù)器文件的大小
- reqFTP.ContentLength = fileInf.Length;
- // 緩沖大小設(shè)置為2kb
- int buffLength = 2048;
- byte[] buff = new byte[buffLength];
- int contentLen;
- // 打開一個(gè)文件流 (System.IO.FileStream) 去讀上傳的文件
- FileStream fs = fileInf.OpenRead();
- try
- {
- // 把上傳的文件寫入流
- Stream strm = reqFTP.GetRequestStream();
- // 每次讀文件流的2kb
- contentLen = fs.Read(buff, 0, buffLength);
- // 流內(nèi)容沒有結(jié)束
- while (contentLen != 0)
- {
- // 把內(nèi)容從file stream 寫入 upload stream
- strm.Write(buff, 0, contentLen);
- contentLen = fs.Read(buff, 0, buffLength);
- }
- // 關(guān)閉兩個(gè)流
- strm.Close();
- fs.Close();
- }
- catch (Exception ex)
- {
- MessageBox.Show(ex.Message, "Upload Error");
- }
- }
【編輯推薦】