HttpMessageHandlerBuilder.CreateHandlerPipeline メソッド

定義

名前空間:

Microsoft.Extensions.Http

アセンブリ:

Microsoft.Extensions.Http.dll

パッケージ:

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

ソース:

HttpMessageHandlerBuilder.cs

チェーンの末尾に primaryHandler を使用して additionalHandlers を 1 つずつ連結して、HttpMessageHandler のインスタンスを構築します。 結果のパイプラインは、カスタマイズされたメッセージ ハンドラーを使用して HttpClient インスタンスを作成するために、IHttpClientFactory インフラストラクチャによって使用されます。 結果のパイプラインには、IHttpClientFactoryの代わりに IHttpMessageHandlerFactory を使用してアクセスすることもできます。

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

ハンドラー チェーンの下部で動作し、実際に HTTP トランスポート操作を処理する HttpMessageHandler のインスタンス。

additionalHandlers

IEnumerable<DelegatingHandler>

HttpRequestMessage の送信と HttpResponseMessageの受信の一環として呼び出される DelegatingHandler インスタンスの順序付きリスト。 ハンドラーは、トップダウン形式で呼び出されます。 つまり、最初のエントリは最初に送信要求メッセージに対して呼び出され、最後は受信応答メッセージに対して呼び出されます。

戻り値

HttpMessageHandler

HTTP メッセージ ハンドラー チェーン。

例外

ArgumentNullException

primaryHandler または additionalHandlers が null。

InvalidOperationException

additionalHandlers には、null エントリが含まれています。

-又は-

DelegatingHandler.InnerHandler は nullされていません。 HttpMessageHandlerBuilder に提供 DelegatingHandler インスタンスを再利用したり、キャッシュしたりすることはできません。