HttpMessageHandlerBuilder.CreateHandlerPipeline メソッド

定義

名前空間:

Microsoft.Extensions.Http

アセンブリ:

Microsoft.Extensions.Http.dll

パッケージ:

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

ソース:

HttpMessageHandlerBuilder.cs

チェーンのHttpMessageHandler末尾で を使用して 1 つずつprimaryHandlerチェーンadditionalHandlersすることによって、 のインスタンスを構築します。 結果のパイプラインは、カスタマイズされたメッセージ ハンドラーを使用してインスタンスを作成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

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

additionalHandlers

IEnumerable<DelegatingHandler>

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

戻り値

HttpMessageHandler

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

例外

ArgumentNullException

primaryHandler または additionalHandlers が null です。

InvalidOperationException

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

- または -

DelegatingHandler.InnerHandler が null ではありません。 DelegatingHandler に指定された インスタンスを HttpMessageHandlerBuilder 再利用またはキャッシュすることはできません。