HttpMessageHandlerBuilder.CreateHandlerPipeline Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.HttpMessageHandlerProtected Friend Shared Function CreateHandlerPipeline (primaryHandler As HttpMessageHandler, additionalHandlers As IEnumerable(Of DelegatingHandler)) As HttpMessageHandlerPará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
Cadena del controlador de mensajes HTTP.
Excepciones
primaryHandler o additionalHandlers es null.
additionalHandlers contiene una null entrada.
O bien
DelegatingHandler.InnerHandler no nulles . Las instancias delegatingHandler proporcionadas a HttpMessageHandlerBuilder no se deben reutilizar ni almacenar en caché.