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.7.24405.7

Source:

HttpMessageHandlerBuilder.cs

Construye una instancia de HttpMessageHandler encadenando additionalHandlers una después de otra con primaryHandler al final de la cadena. La infraestructura de IHttpClientFactory usa la canalización resultante para crear instancias de HttpClient 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 del controlador y controlar realmente las operaciones de transporte HTTP.

additionalHandlers

IEnumerable<DelegatingHandler>

Lista ordenada de instancias de DelegatingHandler que se van a invocar como parte del envío de un HttpRequestMessage y recepción de un 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 entrada de null.

-o-

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