HttpMessageHandlerBuilder.CreateHandlerPipeline Método

Definición

Espacio de nombres:

Microsoft.Extensions.Http

Ensamblado:

Microsoft.Extensions.Http.dll

Paquete:

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

Source:

HttpMessageHandlerBuilder.cs

Construye una instancia de HttpMessageHandler mediante el encadenamiento additionalHandlers uno después de otro con primaryHandler al final de la cadena. La infraestructura usa IHttpClientFactory la canalización resultante para crear HttpClient instancias con controladores de mensajes personalizados. También se puede acceder a la canalización resultante mediante IHttpMessageHandlerFactory en lugar 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

Instancia de HttpMessageHandler para operar en la parte inferior de la cadena de controladores y controlar realmente las operaciones de transporte HTTP.

additionalHandlers

IEnumerable<DelegatingHandler>

Lista ordenada de DelegatingHandler instancias que se invocarán como parte del envío de y HttpRequestMessage la recepción de .HttpResponseMessage Los controladores se invocan de forma descendente. Es decir, la primera entrada se invoca primero para un mensaje de solicitud de salida, pero último para un mensaje de respuesta entrante.

Devoluciones

HttpMessageHandler

Cadena del controlador de mensajes HTTP.

Excepciones

ArgumentNullException

primaryHandler o additionalHandlers es null.

InvalidOperationException

additionalHandlers contiene una null entrada.

o bien

DelegatingHandler.InnerHandler no es null. DelegatingHandler Las instancias proporcionadas a HttpMessageHandlerBuilder no se deben reutilizar ni almacenar en caché.