HttpMessageHandlerBuilder.CreateHandlerPipeline Metoda

Definice

Obor názvů:

Microsoft.Extensions.Http

Sestavení:

Microsoft.Extensions.Http.dll

Balíček:

Microsoft.Extensions.Http v11.0.0-rc.1.26425.128

Zdroj:

HttpMessageHandlerBuilder.cs

Vytvoří instanci HttpMessageHandler zřetězeným additionalHandlers jedním za druhým na primaryHandler konci řetězce. Výsledný kanál je používán infrastrukturou IHttpClientFactory k vytváření HttpClient instancí s přizpůsobenými obslužnými rutinami zpráv. Výsledný kanál lze také získat přístup pomocí namísto IHttpMessageHandlerFactoryIHttpClientFactory.

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

Parametry

primaryHandler

HttpMessageHandler

Instance HttpMessageHandler operace v dolní části řetězu obslužných rutin a ve skutečnosti zpracovávat přenosové operace HTTP.

additionalHandlers

IEnumerable<DelegatingHandler>

Seřazený DelegatingHandler seznam instancí, které mají být vyvolány jako součást odeslání HttpRequestMessage a přijetí .HttpResponseMessage Obslužné rutiny se vyvolávají shora dolů. To znamená, že první položka je vyvolána jako první pro zprávu odchozího požadavku, ale poslední pro příchozí zprávu odpovědi.

Návraty

HttpMessageHandler

Řetězec obslužné rutiny zpráv HTTP.

Výjimky

ArgumentNullException

primaryHandler nebo additionalHandlers je null.

InvalidOperationException

additionalHandlers null obsahuje položku. -or- Vlastnost DelegatingHandler.InnerHandler musí být null. DelegatingHandler instance poskytnuté k opětovnému HttpMessageHandlerBuilder použití ani ukládání do mezipaměti nesmí být použity.