HttpMessageHandlerBuilder.CreateHandlerPipeline Metodo

Definizione

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.

Si applica a