HttpMessageHandlerBuilder.CreateHandlerPipeline Método

Definição

Namespace:

Microsoft.Extensions.Http

Assembly:

Microsoft.Extensions.Http.dll

Pacote:

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

Origem:

HttpMessageHandlerBuilder.cs

Constrói uma instância de HttpMessageHandler encadeando additionalHandlers uma após a outra com primaryHandler no final da cadeia. O pipeline resultante é usado por IHttpClientFactory infraestrutura para criar instâncias HttpClient com manipuladores de mensagens personalizados. O pipeline resultante também pode ser acessado usando IHttpMessageHandlerFactory em vez de 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

Parâmetros

primaryHandler

HttpMessageHandler

Uma instância de HttpMessageHandler operar na parte inferior da cadeia de manipuladores e, na verdade, lidar com as operações de transporte HTTP.

additionalHandlers

IEnumerable<DelegatingHandler>

Uma lista ordenada de instâncias de DelegatingHandler a ser invocada como parte do envio de um HttpRequestMessage e do recebimento de um HttpResponseMessage. Os manipuladores são invocados de forma de cima para baixo. Ou seja, a primeira entrada é invocada primeiro para uma mensagem de solicitação de saída, mas a última para uma mensagem de resposta de entrada.

Retornos

HttpMessageHandler

A cadeia de manipuladores de mensagens HTTP.

Exceções

ArgumentNullException

primaryHandler ou additionalHandlers é null.

InvalidOperationException

additionalHandlers contém uma entrada de null.

-ou-

DelegatingHandler.InnerHandler não é null. DelegatingHandler instâncias fornecidas para HttpMessageHandlerBuilder não devem ser reutilizados ou armazenados em cache.