HttpRequestMessage 类

定义

命名空间:

Windows.Web.Http

表示包含标头的 HTTP 请求消息。

public ref class HttpRequestMessage sealed : IClosable, IStringable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.IHttpRequestMessageFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class HttpRequestMessage final : IClosable, IStringable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Http.IHttpRequestMessageFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpRequestMessage : System.IDisposable, IStringable

function HttpRequestMessage(method, uri)

Public NotInheritable Class HttpRequestMessage
Implements IDisposable, IStringable

继承

Object Platform::Object IInspectable HttpRequestMessage

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IClosable IDisposable IStringable

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

HttpRequestMessage 类包含标头、HTTP 谓词和潜在的数据。 此类通常由需要对 HTTP 请求进行额外控制的开发人员使用。 常见示例包括：

• 检查基础 SSL/TLS 传输信息。
• 使用不太常见的 HTTP 方法。
• 在 HttpRequestMessage 上显式设置请求属性。

在这些情况下，应用使用 HttpRequestMessage 构造函数之一来创建 HttpRequestMessage 实例。 应用根据需要在 HttpRequestMessage 上设置各种属性。 然后，HttpRequestMessage 作为参数传递给 HttpClient.SendRequestAsync 方法之一。

HttpClient 类上的许多便捷方法会自动为应用创建 HttpRequestMessage 对象。 这些方法包括：

• DeleteAsync。
• GetAsync 方法。
• GetBufferAsync。
• GetInputStreamAsync。
• GetStringAsync。
• PostAsync。
• PutAsync。

添加到筛选器管道的任何筛选器都将传递 HttpRequestMessage 对象，无论该对象是由应用显式指定还是为你自动构造的。

构造函数

HttpRequestMessage()	初始化 HttpRequestMessage 类的新实例。
HttpRequestMessage(HttpMethod, Uri)	使用 HTTP 方法和请求 URI 初始化 HttpRequestMessage 类的新实例。

属性

Content	获取或设置要发送到 HttpRequestMessage 对象上的服务器的 HTTP 内容。
Headers	获取与 HttpRequestMessage 关联的 HTTP 请求标头的集合。
Method	获取或设置要对请求 URI 执行的 HTTP 方法。
PrivacyAnnotation	表示包含标头的 HTTP 请求消息。
Properties	获取 HttpRequestMessage 实例上供开发人员使用的属性集。
RequestUri	获取或设置用于 HttpRequestMessage 对象的 URI。
TransportInformation	获取有关 HTTP 连接使用的基础传输套接字的信息。

方法

Close()	关闭 HttpRequestMessage 实例并释放分配的资源。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
ToString()	返回表示当前 HttpRequestMessage 对象的字符串。

另请参阅

• HttpClient
• IClosable
• IStringable