HttpMessageHandlerBuilder.CreateHandlerPipeline メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
チェーンの末尾に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.HttpMessageHandlerProtected Friend Shared Function CreateHandlerPipeline (primaryHandler As HttpMessageHandler, additionalHandlers As IEnumerable(Of DelegatingHandler)) As HttpMessageHandlerパラメーター
- primaryHandler
- HttpMessageHandler
ハンドラー チェーンの下部で動作し、実際に HTTP トランスポート操作を処理する HttpMessageHandler のインスタンス。
- additionalHandlers
- IEnumerable<DelegatingHandler>
HttpRequestMessageの送信とHttpResponseMessageの受信の一環として呼び出されるDelegatingHandler インスタンスの順序付きリスト。 ハンドラーは、トップダウン形式で呼び出されます。 つまり、最初のエントリは最初に送信要求メッセージに対して呼び出され、最後は受信応答メッセージに対して呼び出されます。
返品
HTTP メッセージ ハンドラー チェーン。
例外
primaryHandler または additionalHandlers が null。
additionalHandlers には、 null エントリが含まれています。
または、 DelegatingHandler.InnerHandler プロパティは nullする必要があります。
DelegatingHandler
HttpMessageHandlerBuilderに提供されるインスタンスを再利用したりキャッシュしたりすることはできません。
