C#中的HttpWebRequest类介绍

提供 WebRequest 类的 HTTP 特定的实现。

继承层次结构 System.Object → System.MarshalByRefObject →  System.Net.WebRequest →  System.Net.HttpWebRequest。

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

C#语法：

[SerializableAttribute]

public class HttpWebRequest : WebRequest, ISerializable

HttpWebRequest 类型公开以下成员。

1、构造函数

2、属性

3、方法

4、显示接口实现

5、备注

HttpWebRequest类对WebRequest中定义的属性和方法提供支持，也对使用户能够直接与使用 HTTP 的服务器交互的附加属性和方法提供支持。

不要使用HttpWebRequest 构造函数。使用 WebRequest.Create方法初始化新的 HttpWebRequest 对象。如果统一资源标识符 (URI) 的方案是 http:// 或 https://，则 Create 返回 HttpWebRequest 对象。 

GetResponse方法向RequestUri属性中指定的资源发出同步请求并返回包含该响应的HttpWebResponse。可以使用 BeginGetResponse 和 EndGetResponse 方法对资源发出异步请求。 

当要向资源发送数据时，GetRequestStream 方法返回用于发送数据的 Stream 对象。BeginGetRequestStream和EndGetRequestStream方法提供对发送数据流的异步访问。 

对于使用 HttpWebRequest 的客户端验证身份，客户端证书必须安装在当前用户的“我的证书”存储区中。

如果在访问资源时发生错误，则 HttpWebRequest 类将引发 WebException。WebException.Status 属性包含指示错误源的 WebExceptionStatus 值。  当 WebException.Status 为 WebExceptionStatus.ProtocolError 时，Response 属性包含从资源接收的 HttpWebResponse。 

HttpWebRequest将发送到 Internet 资源的公共 HTTP 标头值公开为属性，由方法或系统设置；下表包含完整列表。可以将 Headers 属性中的其他标头设置为名称/值对。注意，服务器和缓存在请求期间可能会更改或添加标头。 

下表列出了由属性或方法设置或由系统设置的 HTTP 标头。

本地计算机或应用程序配置文件可能指定使用默认代理。  如果指定了 Proxy 属性，则 Proxy 属性中的代理设置会重写本地计算机或应用程序配置文件，并且 HttpWebRequest 实例将实用指定的代理设置。  如果配置文件中未指定代理并且未指定 Proxy 属性，则 HttpWebRequest 类使用从本地计算机上的 Internet Explorer 中继承的代理设置。  如果 Internet Explorer 中没有代理设置，请求会直接发送到服务器。

HttpWebRequest   类分析从 Internet Explorer 继承的且包含通配符的代理忽略列表时会与 Internet Explorer 直接分析忽略列表不同。  例如，HttpWebRequest 类将来自 Internet Explorer 的其中包含“nt*”的忽略列表分析为正则表达式“nt.$”。  此行为不同于 Internet Explorer 的本机行为。  因此 URL“http://intxxxxx”将忽略使用 HttpWebRequest 类的代理，但它不会忽略使用 Internet Explorer 的代理。 

示例

下面的代码示例为 URI http://www.contoso.com/. 创建 HttpWebRequest。

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