C# 之 HttpWebResponse类
提供 WebResponse 类的 HTTP 特定的实现。
命名空间： System.Net ； 程序集：System（在 System.dll 中）。
[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 对象中。 |
 说明 |
|---|
|
不要混淆 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();
