HttpMessageHandlerBuilder.CreateHandlerPipeline 方法

定义

命名空间:

Microsoft.Extensions.Http

程序集:

Microsoft.Extensions.Http.dll

包:

Microsoft.Extensions.Http v9.0.0-preview.7.24405.7

Source:

HttpMessageHandlerBuilder.cs

通过将 additionalHandlers 一个接一个地链接到链末尾的 primaryHandler 来构造 HttpMessageHandler 的实例。 生成的管道由 IHttpClientFactory 基础结构用来创建具有自定义消息处理程序的 HttpClient 实例。 也可以使用 IHttpMessageHandlerFactory 而不是 IHttpClientFactory来访问生成的管道。

protected public:
 static System::Net::Http::HttpMessageHandler ^ CreateHandlerPipeline(System::Net::Http::HttpMessageHandler ^ primaryHandler, System::Collections::Generic::IEnumerable<System::Net::Http::DelegatingHandler ^> ^ additionalHandlers);

protected internal static System.Net.Http.HttpMessageHandler CreateHandlerPipeline (System.Net.Http.HttpMessageHandler primaryHandler, System.Collections.Generic.IEnumerable<System.Net.Http.DelegatingHandler> additionalHandlers);

static member CreateHandlerPipeline : System.Net.Http.HttpMessageHandler * seq<System.Net.Http.DelegatingHandler> -> System.Net.Http.HttpMessageHandler

Protected Friend Shared Function CreateHandlerPipeline (primaryHandler As HttpMessageHandler, additionalHandlers As IEnumerable(Of DelegatingHandler)) As HttpMessageHandler

参数

primaryHandler

HttpMessageHandler

HttpMessageHandler 实例，用于在处理程序链底部操作并实际处理 HTTP 传输操作。

additionalHandlers

IEnumerable<DelegatingHandler>

要作为发送 HttpRequestMessage 并接收 HttpResponseMessage的一部分调用的 DelegatingHandler 实例的有序列表。 处理程序以自上而下的方式调用。 也就是说，首先为出站请求消息调用第一个条目，但最后一个条目用于入站响应消息。

返回

HttpMessageHandler

HTTP 消息处理程序链。

例外

ArgumentNullException

primaryHandler 或 additionalHandlers null。

InvalidOperationException

additionalHandlers 包含 null 项。

-或-

DelegatingHandler.InnerHandler 不是 null。 提供给 HttpMessageHandlerBuilder 的 DelegatingHandler 实例不得重复使用或缓存。