C# 之 HttpWebResponse類

      提供 WebResponse 類的 HTTP 特定的實現。                       

      繼承層次結構 ，"System .Object→System .MarshalByRefObject→System.Net .WebResponse→ System.Net.HttpWebResponse

      命名空間： System.Net ；  程序集：System（在 System.dll 中）。

      C#語法

  [SerializableAttribute]
  public class HttpWebResponse : WebResponse, ISerializable 

     HttpWebResponse 類型公開如下成員。

一、構造函數           

名稱	說明
HttpWebResponse()	已過期。初始化 HttpWebResponse 類的新實例。
HttpWebResponse(SerializationInfo, StreamingContext)	已過期。根據指定的 SerializationInfo 和 StreamingContext 實例初始化 HttpWebResponse 類的新實例。

 

二、屬性             

名稱	說明
CharacterSet	獲取響應的字符集。
ContentEncoding	獲取用於對響應體進行編碼的方法。
ContentLength	獲取請求返回的內容的長度。 （重寫 WebResponse.ContentLength。）
ContentType	獲取響應的內容類型。 （重寫 WebResponse.ContentType。）
Cookies	獲取或設置與此響應關聯的 Cookie。
Headers	獲取來自服務器的與此響應關聯的標頭。 （重寫 WebResponse.Headers。）
IsFromCache	獲取一個 Boolean值，該值指示此響應是否爲從緩存中獲取的。 （繼承自 WebResponse。）
IsMutuallyAuthenticated	獲取一個 Boolean 值，該值指示客戶端和服務器是否都已通過身份驗證。 （重寫 WebResponse.IsMutuallyAuthenticated。）
LastModified	獲取最後一次修改響應內容的日期和時間。
Method	獲取用於返回響應的方法。
ProtocolVersion	獲取響應中使用的 HTTP 協議的版本。
ResponseUri	獲取響應請求的 Internet 資源的 URI。 （重寫 WebResponse.ResponseUri。）
Server	獲取發送響應的服務器的名稱。
StatusCode	獲取響應的狀態。
StatusDescription	獲取與響應一塊兒返回的狀態說明。
SupportsHeaders	獲取指示是否支持標題的值。 （重寫 WebResponse.SupportsHeaders。）

 

三、方法    

名稱	說明
Close	關閉響應流。 （重寫 WebResponse.Close()。）
CreateObjRef	建立一個對象，該對象包含生成用於與遠程對象進行通訊的代理所需的所有相關信息。 （繼承自 MarshalByRefObject。）
Dispose()	釋放 WebResponse 對象使用的非託管資源。 （繼承自 WebResponse。）
Dispose(Boolean)	釋放由 HttpWebResponse 使用的非託管資源，並可根據須要釋放託管資源。 （重寫 WebResponse.Dispose(Boolean)。）
Equals(Object)	肯定指定的對象是否等於當前對象。 （繼承自 Object。）
Finalize	容許對象在「垃圾回收」回收以前嘗試釋放資源並執行其餘清理操做。 （繼承自 Object。）
GetHashCode	做爲默認哈希函數。 （繼承自 Object。）
GetLifetimeService	檢索控制此實例的生存期策略的當前生存期服務對象。 （繼承自 MarshalByRefObject。）
GetObjectData	基礎結構。使用將目標對象序列化所需的數據填充 SerializationInfo。 （重寫 WebResponse.GetObjectData(SerializationInfo, StreamingContext)。）
GetResponseHeader	獲取與響應一塊兒返回的標頭的內容。
GetResponseStream	獲取流，該流用於讀取來自服務器的響應的體。 （重寫 WebResponse.GetResponseStream()。）
GetType	獲取當前實例的 Type。 （繼承自 Object。）
InitializeLifetimeService	獲取控制此實例的生存期策略的生存期服務對象。 （繼承自 MarshalByRefObject。）
MemberwiseClone()	建立當前 Object 的淺表副本。 （繼承自 Object。）
MemberwiseClone(Boolean)	建立當前 MarshalByRefObject 對象的淺表副本。 （繼承自 MarshalByRefObject。）
ToString	返回表示當前對象的字符串。 （繼承自 Object。）

 

四、顯式接口實現

名稱	說明
IDisposable.Dispose	基礎結構。當在派生類中被重寫時，釋放 WebResponse 使用的全部資源。 （繼承自 WebResponse。）
ISerializable.GetObjectData	基礎結構。將此實例序列化到指定的 SerializationInfo 對象中。

 

五、備註

      此類包含對 WebResponse 類中的屬性和方法的 HTTP 特定用法的支持。  HttpWebResponse   類用於生成發送 HTTP 請求和接收 HTTP 響應的 HTTP 獨立客戶端應用程序。 

說明
不要混淆 HttpWebResponse 和 HttpResponse 類；後者用於 ASP.NET 應用程序，並且它的方法和屬性是經過 ASP.NET 的內部 Response 對象公開的。

      決不要直接建立 HttpWebResponse 類的實例。  而應當使用經過調用 HttpWebRequest.GetResponse 所返回的實例。  您必須調用 Stream.Close 方法或 HttpWebResponse.Close 方法來關閉響應並將鏈接釋放出來供重用。  沒必要同時調用 Stream.Close 和 HttpWebResponse.Close，但這樣作不會致使錯誤。 

      從 Internet 資源返回的公共標頭信息公開爲該類的屬性。  有關完整的列表，請參見下表。  能夠從 Headers 屬性以名稱/值對的形式讀取其餘標頭。 

      下表顯示能夠經過 HttpWebResponse 類的屬性使用的公共 HTTP 標頭。

 

Header	Property
內容編碼	ContentEncoding
Content-Length	ContentLength
Content-Type	ContentType
上次修改時間	LastModified
服務器	Server

      經過調用 GetResponseStream 方法，以 Stream 的形式返回來自 Internet 資源的響應的內容。

六、示例

HttpWebRequest HttpWReq = 
(HttpWebRequest)WebRequest.Create("http://www.contoso.com");

HttpWebResponse HttpWResp = (HttpWebResponse)HttpWReq.GetResponse();
// Insert code that uses the response object. HttpWResp.Close();