HttpMessageHandlerBuilder.CreateHandlerPipeline 方法

定義

命名空間:

Microsoft.Extensions.Http

組件:

Microsoft.Extensions.Http.dll

套件:

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

來源:

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>

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

傳回

HttpMessageHandler

HTTP 訊息處理程式鏈結。

例外狀況

ArgumentNullException

primaryHandler 或 additionalHandlers null。

InvalidOperationException

additionalHandlers 包含 null 專案。

-或-

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