HttpMessageHandlerBuilder.CreateHandlerPipeline Metodo

Definizione

Costruisce un'istanza di HttpMessageHandler concatenandone additionalHandlers una dopo l'altra con primaryHandler alla fine della catena. La pipeline risultante viene usata dall'infrastruttura IHttpClientFactory per creare HttpClient istanze 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 per operare nella parte inferiore della catena del gestore e gestire effettivamente le operazioni di HttpMessageHandler trasporto HTTP.

additionalHandlers
IEnumerable<DelegatingHandler>

Elenco ordinato di DelegatingHandler istanze da richiamare come parte dell'invio di un oggetto HttpRequestMessage e della ricezione di un oggetto 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.

Valori restituiti

Catena del gestore di messaggi HTTP.

Eccezioni

primaryHandler o additionalHandlers è null.

additionalHandlers contiene una null voce. -oppure- La DelegatingHandler.InnerHandler proprietà deve essere null. DelegatingHandler Le istanze fornite a HttpMessageHandlerBuilder non devono essere riutilizzate o memorizzate nella cache.

Si applica a