IHttpFilter.SendRequestAsync(HttpRequestMessage) 方法

定义

命名空间:

Windows.Web.Http.Filters

以异步操作的形式在 IHttpFilter 实例上发送 HTTP 请求。

public:
 IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ SendRequestAsync(HttpRequestMessage ^ request);

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> SendRequestAsync(HttpRequestMessage const& request);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> SendRequestAsync(HttpRequestMessage request);

function sendRequestAsync(request)

Public Function SendRequestAsync (request As HttpRequestMessage) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)

参数

request

HttpRequestMessage

要发送的 HTTP 请求消息。

返回

IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress>

表示异步操作的 对象。

属性

RemoteAsyncAttribute

注解

自定义筛选器在其 IHttpFilter 接口上的 SendRequestAsync 方法中实现。

Windows.Web.Http 命名空间中的类支持基于 Windows.Web.Http.Filters 命名空间中的类使用筛选器。 Windows.Web.Http 命名空间中的 HttpClient 类提供用于发送 HTTP 请求和接收 HTTP 响应的基类。 筛选器提供处理程序机制来帮助解决常见的 HTTP 服务问题。 简单的筛选器可以按顺序链接在一起，以处理更复杂的 HTTP 服务问题。

HTTP 筛选器是一个黑盒，它接受 HTTP 请求消息并生成 HTTP 响应消息。 筛选器获取 HTTP 响应的方式由筛选器开发人员确定。 应用可以立即创建响应，可以通过 TCP 将请求发送到服务器，甚至可以在生成响应消息之前将多个请求发送到服务器 (或多个服务器) 。 由于未指定筛选器如何获取响应消息，因此筛选器可以将请求消息传递给名为内部筛选器) 的另一个筛选器 (，从而将响应消息的创建委托给内部筛选器。

筛选器通常添加或更改标头、处理授权 (可能使用 WebAuthenticationBroker) ，或者根据网络条件允许或禁止请求。 筛选器通常进行更改，然后将请求传递给内部筛选器，内部筛选器通常在构造筛选器时设置。

此方法允许筛选器仅负责 HTTP 请求执行的特定方面，并将其他方面委托给其他筛选器。 筛选器可以实现缓存、身份验证、重定向、Cookie、与服务器的实际通信或这些组合。 最底层 (基) 筛选器通常是与网络进行实际通信的筛选器。

下面是此函数引发的一些异常。

E_INVALIDARG

在 Visual Basic) 中 ，请求 参数为 null 引用 (Nothing 。

E_ILLEGAL_METHOD_CALL

请求消息已由 IHttpFilter 实例发送。