HttpMessageHandlerBuilder.CreateHandlerPipeline Metodo

Definizione

Spazio dei nomi:

Microsoft.Extensions.Http

Assembly:

Microsoft.Extensions.Http.dll

Pacchetto:

Microsoft.Extensions.Http v9.0.0-preview.5.24306.7

Origine:

HttpMessageHandlerBuilder.cs

Costruisce un'istanza di HttpMessageHandler tramite concatenamento additionalHandlers uno dopo l'altro 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 HttpMessageHandler per operare nella parte inferiore della catena del gestore e gestire effettivamente le operazioni di trasporto HTTP.

additionalHandlers

IEnumerable<DelegatingHandler>

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

Restituisce

HttpMessageHandler

Catena del gestore di messaggi HTTP.

Eccezioni

ArgumentNullException

primaryHandler o additionalHandlers è null.

InvalidOperationException

additionalHandlers contiene una null voce.

-oppure-

DelegatingHandler.InnerHandler non è null. DelegatingHandler Le istanze fornite a HttpMessageHandlerBuilder non devono essere riutilizzate o memorizzate nella cache.