HttpMessageHandlerBuilder.CreateHandlerPipeline Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Costruisce un'istanza di HttpMessageHandler concatenando una additionalHandlers
dopo l'altra con primaryHandler
alla fine della catena. La pipeline risultante viene usata dall'infrastruttura IHttpClientFactory per creare istanze di HttpClient con gestori di messaggi personalizzati. È anche possibile accedere alla pipeline risultante usando IHttpMessageHandlerFactory anziché 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
Parametri
- primaryHandler
- HttpMessageHandler
Istanza di HttpMessageHandler per operare nella parte inferiore della catena del gestore e gestire effettivamente le operazioni di trasporto HTTP.
- additionalHandlers
- IEnumerable<DelegatingHandler>
Elenco ordinato di istanze di DelegatingHandler da richiamare come parte dell'invio di un HttpRequestMessage e ricezione di un HttpResponseMessage. I gestori vengono richiamati in modo dall'alto verso il basso. Ovvero, la prima voce viene richiamata per primo per un messaggio di richiesta in uscita, ma per ultimo per un messaggio di risposta in ingresso.
Restituisce
Catena del gestore di messaggi HTTP.
Eccezioni
primaryHandler
o additionalHandlers
è null
.
additionalHandlers
contiene una voce di null
.
-o-
DelegatingHandler.InnerHandler
non è null
.
DelegatingHandler
istanze fornite per HttpMessageHandlerBuilder
non devono essere riutilizzate o memorizzate nella cache.