此页面有用吗?
您对此内容的反馈非常重要。 请告诉我们您的想法。
更多反馈?
1500 个剩余字符
导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

WebRequest 类

2013/12/13

发出对统一资源标识符 (URI) 的请求。这是一个 abstract 类。

Namespace:  System.Net
程序集:  System.Net(位于 System.Net.dll 中)

public abstract class WebRequest

WebRequest 类型公开以下成员。

  名称说明
受保护的方法WebRequest初始化 WebRequest 类的新实例。
返回顶部

  名称说明
公共属性ContentLength如果已在子类中重写,则获取或设置发送的请求数据的内容长度。
公共属性ContentType如果已在子类中重写,则获取或设置发送的请求数据的内容类型。
公共属性CreatorInstance当在子类中重写时,获取从 IWebRequestCreate 类派生的工厂对象,该类用于创建为生成对指定 URI 的请求而实例化的 WebRequest
公共属性Credentials如果已在子类中重写,则获取或设置用于对 Internet 资源的请求进行身份验证的网络凭据。
公共属性Headers如果已在子类中重写,则获取或设置与请求关联的标头名称/值对集合。
公共属性Method如果已在子类中重写时,则获取或设置要在此请求中使用的协议方法。
公共属性RequestUri如果已在子类中重写,则获取与请求关联的 Internet 资源的 URI。
公共属性UseDefaultCredentials当在子代类中重写时,获取或设置一个 Boolean 值,该值控制默认凭据是否随请求一起发送。
返回顶部

  名称说明
公共方法Abort中止请求。
公共方法BeginGetRequestStream如果已在子类中重写,则提供请求流的异步方法。
公共方法BeginGetResponse如果已在子类中重写,则开始对 Internet 资源的异步请求。
公共方法静态成员Create(String)为指定的 URI 方案初始化新的 WebRequest 实例。
公共方法静态成员Create(Uri)为指定的 URI 方案初始化新的 WebRequest 实例。
公共方法静态成员CreateHttp(String)为指定的 URI 字符串初始化新的 HttpWebRequest 实例。
公共方法静态成员CreateHttp(Uri)为指定的 URI 初始化新的 HttpWebRequest 实例。
公共方法EndGetRequestStream当在子类中重写时,返回用于将数据写入 Internet 资源的 Stream
公共方法EndGetResponse当在子类中重写时,返回 WebResponse
公共方法Equals(Object)确定指定的 Object 是否等于当前的 Object (从 Object 继承。)
受保护的方法Finalize允许 Object 在垃圾回收器回收该对象之前尝试释放资源并执行其他清理操作。 (从 Object 继承。)
公共方法GetHashCode用作特定类型的哈希函数。 (从 Object 继承。)
公共方法GetType获取当前实例的 Type (从 Object 继承。)
受保护的方法MemberwiseClone创建当前 Object 的浅表副本。 (从 Object 继承。)
公共方法静态成员RegisterPrefix为指定的 URI 注册 WebRequest 子代。
公共方法ToString返回一个字符串,它表示当前的对象。 (从 Object 继承。)
返回顶部

  名称说明
公共扩展方法GetCurrentNetworkInterface获取有关与 Web 请求相对应的网络接口的所有可用信息。 (由 WebRequestExtensions 定义。)
公共扩展方法SetNetworkPreference设置 Web 请求的首选项,以使用蜂窝或非蜂窝技术。 (由 WebRequestExtensions 定义。)
公共扩展方法SetNetworkRequirement设置 Web 请求的要求,以使用蜂窝或非蜂窝技术。 (由 WebRequestExtensions 定义。)
返回顶部

WebRequest 是 .NET Framework 的请求/响应模型的 abstract 基类,用于访问 Internet 数据。使用该请求/响应模型的应用程序可以用协议不可知的方式从 Internet 请求数据,在这种方式下,应用程序处理 WebRequest 类的实例,而协议特定的子类则执行请求的具体细节。

请求从应用程序发送到某个特定的 URI,如服务器上的网页。URI 从一个为应用程序注册的 WebRequest 子代列表中确定要创建的适当子类。注册 WebRequest 子代通常是为了处理某个特定的协议(如 HTTP 或 HTTPS),但是也可以注册它以处理对特定服务器或服务器上的路径的请求。

如果在访问 Internet 资源时发生错误,则 WebRequest 类将引发 WebExceptionStatus 属性是 WebExceptionStatus 值之一,它指示错误源。

StatusUnknownError 时,使用 Response 属性可以获得有关协议特定响应错误的其他详细信息。如果 Response 属性不为 null,则表明远程服务器以错误代码进行响应。在这种情况下,可以查询 Response 属性来获取有关该响应的更多具体信息。

因为 WebRequest 类是一个 abstract 类,所以 WebRequest 实例在运行时的实际行为由 Create 方法所返回的子类确定。有关默认值和异常的更多信息,请参见有关子类的文档,如 HttpWebRequest

说明注意:

使用 Create 方法初始化新的 WebRequest 实例。不要使用 WebRequest 构造函数。

功能

如果您在应用中使用此 API,您必须在应用清单中指定下列功能。否则,您的应用可能无法正常工作,或可能意外退出。

ID_CAP_NETWORKING

Windows Phone 8, Windows Phone OS 7.1

有关更多信息,请参见 Windows Phone 应用的功能和硬件要求

对继承者的说明

WebRequest 继承时,必须重写以下成员:MethodRequestUriHeadersContentTypeCredentialsAbortBeginGetRequestStreamEndGetRequestStreamBeginGetResponseEndGetResponse。此外,必须提供 IWebRequestCreate 接口的实现,该接口定义了调用 Create 时使用的 Create 方法。您必须通过使用 RegisterPrefix 方法来注册实现 IWebRequestCreate 接口的类。

Windows Phone OS

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

此类型的所有公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

显示:
© 2015 Microsoft