C# 網(wǎng) 絡(luò)(WebClient類)
當(dāng)前位置:點晴教程→知識管理交流
→『 技術(shù)文檔交流 』
? WebClient類如果只想從特定的URI(Uniform Resource Identifier,統(tǒng)一資源標(biāo)識符)請求文件,則可以使用的最簡單的.NET 類是System.Net.WebClient。這個類是非常高層的類,它只用一兩條命令執(zhí)行基本操 作。.NET Framework 目前支持以http:、https:和file:標(biāo)識符開頭的URI。 術(shù)語 URL(統(tǒng)一資源定位符)在新的技術(shù)規(guī)范中已不再使用,現(xiàn)在更常使用的是 URI(統(tǒng)一資源標(biāo)識符)。URI 的含義大致與URL 相同,但URI 更通用,因為它不意味 著用戶正在使用其中一個熟悉的協(xié)議,如HTTP 或FTP。 下載文件使用 WebClient 類下載文件有兩種方法,具體使用哪一種方法取決于文件內(nèi)容的處理方式。如 果只想把文件保存到磁盤上,就應(yīng)該使用DownloadFile()方法。這個方法有兩個參數(shù):即文件的URI 和保存所請求的數(shù)據(jù)的位置(路徑和文件名):
更為常見的是,應(yīng)用程序需要處理從Web 站點檢索到的數(shù)據(jù)。為此,要使用OpenRead()方法, 這個方法返回一個Stream 引用。然后,就可以把數(shù)據(jù)從數(shù)據(jù)流中提取到內(nèi)存中:
基本的WebClient示例第一個示例將闡述怎樣使用WebClient.OpenRead()方法。這個示例將把下載的頁面顯示在 ListBox 控件中。首先,作為標(biāo)準(zhǔn)的C# Windows 窗體應(yīng)用程序新建項目,添加一個名為listBox1 的 列表框,將其docking 屬性設(shè)置為DockStyle.Fill。在文件的開頭,需要在using 指令列表中添加 System.Net 和System.IO 名稱空間引用,然后對主窗體的構(gòu)造函數(shù)進(jìn)行以下改動:
在這個示例中,把System.IO 名稱空間中的StreamReader 類與網(wǎng)絡(luò)數(shù)據(jù)流關(guān)聯(lián)起來。這樣,就 可以使用高層方法,例如ReadLine()方法,從數(shù)據(jù)流中以文本的形式獲取數(shù)據(jù)。據(jù)移動抽象化為數(shù)據(jù)流概念的優(yōu)點,這個示例就充分體現(xiàn)出了這一點。 WebClient 類還有一個OpenWrite()方法,它可以返回一個可寫的數(shù)據(jù)流,便于用戶把數(shù)據(jù)發(fā)送 給URI。也可以指定用于把數(shù)據(jù)發(fā)送給主機(jī)的方法;默認(rèn)的方法是POST。下面的代碼段假定在本 地計算機(jī)上有一個可寫的目錄accept,這段代碼在該目錄下創(chuàng)建newfile.txt 文件,其內(nèi)容為“Hello World”:
上傳文件WebClient 類還提供了UploadFile()和UploadData()方法。在需要投遞HTML 窗體或上傳整個文 件時,就可以使用這兩個方法。UploadFile()方法把文件上傳到指定的位置,其中文件名已經(jīng)給出; 而UploadData()方法把作為字節(jié)數(shù)組提供的二進(jìn)制數(shù)據(jù)上傳至指定的URI(還有一個DownloadData() 方法,用于從URI 中檢索字節(jié)數(shù)組):
WebClient 類還提供了UploadFile()和UploadData()方法。在需要投遞HTML 窗體或上傳整個文 件時,就可以使用這兩個方法。UploadFile()方法把文件上傳到指定的位置,其中文件名已經(jīng)給出; 而UploadData()方法把作為字節(jié)數(shù)組提供的二進(jìn)制數(shù)據(jù)上傳至指定的URI(還有一個DownloadData() 方法,用于從URI 中檢索字節(jié)數(shù)組): WebRequest類和WebResponse類WebRequest 類代表要給某個特定URI 發(fā)送信息的請求,URI 作為參數(shù)傳遞給Create()方法。 WebResponse 類代表從服務(wù)器檢索的數(shù)據(jù)。調(diào)用WebRequest.GetResponse()方法,實際上是把請求發(fā) 送給Web 服務(wù)器,并創(chuàng)建一個WebResponse 對象,以檢查返回的數(shù)據(jù)。與WebClient 對象一樣,可以 得到一個代表數(shù)據(jù)的數(shù)據(jù)流,但是,這里的數(shù)據(jù)流使用WebResponse.GetResponseStream()方法獲得。 首先討論怎樣使用這些類下載Web 頁面——這個示例與前面的示例一樣,但使用WebRequest 和WebResponse 類。在此過程中,將解釋涉及的類的層次結(jié)構(gòu),然后闡述怎樣利用這個層次結(jié)構(gòu)所 支持的其他HTTP 功能。 修改了BasicWebClient 示例,以使用WebRequest 類和WebResponse 類。
在這段代碼中,首先對代表Web 請求的對象進(jìn)行實例化。但在此沒有使用構(gòu)造函數(shù),而是調(diào)用 靜態(tài)的WebRequest.Create()方法,WebRequest 類是支持不同網(wǎng)絡(luò)協(xié)議的類的層次 結(jié)構(gòu)的一部分,為了給請求類型接收一個對正確對象的引用,需要一個工廠機(jī)制。WebRequest.Create() 方法會為給定的協(xié)議創(chuàng)建合適的對象。 HTTP 協(xié)議的一個重要方面就是能夠利用請求數(shù)據(jù)流和響應(yīng)數(shù)據(jù)流發(fā)送擴(kuò)展的標(biāo)題信息。標(biāo)題 信息可以包括cookies 以及發(fā)送請求的特定瀏覽器(用戶代理)的詳細(xì)信息。果然,.NET Framework 為訪問最重要的數(shù)據(jù)提供了全方位的支持。WebRequest 類和WebResponse 類提供了讀取標(biāo)題信息的一些支持。而兩個派生的類HttpWebRequest 和HttpWebResponse 提供了其他HTTP 特定的信息。 因為 HttpWebRequest 對象實例派生自WebRequest 類,所以可以在需要WebRequest 類的任何地方使用新 實例。另外,還可以把實例的類型強(qiáng)制轉(zhuǎn)換為HttpWebRequest 引用,并訪問HTTP 協(xié)議特定的屬性。 同樣,在使用HTTP 時,GetResponse()方法調(diào)用會把HttpWebResponse 實例返回為WebResponse 引 用。也可以進(jìn)行一個簡單的強(qiáng)制轉(zhuǎn)換,以訪問HTTP 特定的功能。 在 GetResponse()方法調(diào)用之前添加如下代碼,可以檢查兩個標(biāo)題屬性的某些內(nèi)容:
Timeout 屬性的單位是毫秒,其默認(rèn)值是100 000??梢栽O(shè)置這個屬性,以控制WebRequest 對 象在拋出WebException 異常之前等待相應(yīng)的響應(yīng)時間??梢詸z查WebException.Status 屬性,以查看 產(chǎn)生異常的原因。這個枚舉包括超時、連接失敗、協(xié)議錯誤等的狀態(tài)碼。 因為 KeepAlive 屬性是對HTTP 協(xié)議的特定擴(kuò)展,所以可以通過HttpWebRequest 引用訪問這個 屬性。KeepAlive 屬性允許多個請求使用同一個連接,在后續(xù)的請求中節(jié)省關(guān)閉和重新打開連接的 時間。其默認(rèn)值為true。 AllowAutoRedirec 屬性也專用于HttpWebRequest 類,使用這個屬性可以控制Web 請求是否應(yīng)自 動跟隨Web 服務(wù)器上的重定向響應(yīng)。其默認(rèn)值也是true。如果只允許有限次數(shù)的重定向,就可以把 HttpWebRequest 類的MaximumAutomaticRedirections 屬性設(shè)置為期望的數(shù)值。 請求類和響應(yīng)類以屬性的形式提供大多數(shù)重要的標(biāo)題,也可以使用Headers 屬性本身顯示標(biāo)題 的整個集合。在GetResponse()方法調(diào)用的后面添加如下代碼,可以把所有標(biāo)題放在列表框控件中:
身份驗證WebRequest 類中的另一個屬性是Credentials 屬性。如果需要把身份驗證證書附帶在請求中,就 可以用用戶名和密碼創(chuàng)建NetworkCredential 類(也在System.Net 名稱空間中)的一個實例。在調(diào)用 GetResponse()方法之前,添加下述代碼:
使用代理許多公司都需要使用代理服務(wù)器進(jìn)行所有類型的HTTP 或FTP 請求。代理服務(wù)器常常使用某種 形式的安全性(通常是用戶名和密碼),路由公司的所有請求和響應(yīng)。對于使用WebClient 對象或 WebRequest 對象的應(yīng)用程序,需要考慮這些代理服務(wù)器。與前面的NetworkCredential 對象一樣,在 進(jìn)行調(diào)用以執(zhí)行實際請求之前,需要使用WebProxy 對象。
如果除了證書之外,還需要設(shè)計用戶的域,就應(yīng)在NetworkCredential 實例上使用另一個簽名:
異步頁面請求WebRequest 類的另一個特性就是可以異步地請求頁面。這個特性很重要,因為在給主機(jī)發(fā)送請 求到接收響應(yīng)之間有很長的延遲。WebClient.DownloadData()和WebRequest.GetResponse()等方法在 響應(yīng)沒有從服務(wù)器回來之前,是不會返回的。如果不希望在那段時間中應(yīng)用程序處于等待狀態(tài),則 最好使用BeginGetResponse()方法和EndGetResponse()方法,BeginGetResponse()方法可以異步地工 作,并立即返回。在底層,運(yùn)行庫會異步地管理一個后臺線程,以從服務(wù)器上接收響應(yīng)。 BeginGetResponse()方法不返回WebResponse 對象,而是返回一個實現(xiàn)IAsyncResult 接口的對象。使 用這個接口可以選擇或等待可用的響應(yīng),然后調(diào)用EndGetResponse()方法搜集結(jié)果。 也可以把一個回調(diào)委托傳遞給BeginGetResponse()方法。該回調(diào)委托的目的地是一個返回類型 為void 并把IAsyncResult 引用作為參數(shù)的方法,當(dāng)工作線程搜集完響應(yīng)后,運(yùn)行庫就調(diào)用該回調(diào)委 托,以通知用戶工作已完成。如下面的代碼所示,在回調(diào)方法中調(diào)用EndGetResponse()方法可以檢 索WebResponse 對象:
注意可以作為BeginGetResponse()的第二個參數(shù)傳遞WebRequest 對象,檢索最初的WebRequest 對象。第二個參數(shù)是一個對象引用,稱為狀態(tài)參數(shù)。在回調(diào)方法的過程中,可以使用IAsyncResult 接口的AsyncState 屬性檢索相同的狀態(tài)對象。 閱讀原文:原文鏈接 該文章在 2025/3/31 11:14:51 編輯過 |
關(guān)鍵字查詢
相關(guān)文章
正在查詢... |