HttpMessageHandlerBuilder.CreateHandlerPipeline 方法

定義

命名空間:

Microsoft.Extensions.Http

組件:

Microsoft.Extensions.Http.dll

套件:

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

來源:

HttpMessageHandlerBuilder.cs

藉由在鏈結結尾與鏈結彼此鏈additionalHandlersprimaryHandler結，來建構的實例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>

要做為傳送和接收HttpResponseMessage的HttpRequestMessage一部分叫用之實例的已排序列表DelegatingHandler。 處理程式會以由上而下的方式叫用。 也就是說，會先針對輸出要求訊息叫用第一個專案，但最後一個專案是輸入回應消息。

傳回

HttpMessageHandler

HTTP 訊息處理程式鏈結。

例外狀況

ArgumentNullException

primaryHandler 或 additionalHandlers 為 null。

InvalidOperationException

additionalHandlers 包含專案 null 。

-或-

DelegatingHandler.InnerHandler 不是 null。 DelegatingHandler 提供給的 HttpMessageHandlerBuilder 實例不得重複使用或快取。