HttpMessageHandlerBuilder.CreateHandlerPipeline Metoda

Definicja

Przestrzeń nazw:

Microsoft.Extensions.Http

Zestaw:

Microsoft.Extensions.Http.dll

Pakiet:

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

Źródło:

HttpMessageHandlerBuilder.cs

Tworzy wystąpienie HttpMessageHandler, łącząc additionalHandlers jeden po drugim z primaryHandler na końcu łańcucha. Wynikowy potok jest używany przez infrastrukturę IHttpClientFactory do tworzenia wystąpień HttpClient z niestandardowymi procedurami obsługi komunikatów. Dostęp do wynikowego potoku można również uzyskać przy użyciu IHttpMessageHandlerFactory zamiast 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

Parametry

primaryHandler

HttpMessageHandler

Wystąpienie HttpMessageHandler do działania w dolnej części łańcucha obsługi i faktycznie obsługuje operacje transportu HTTP.

additionalHandlers

IEnumerable<DelegatingHandler>

Uporządkowana lista wystąpień DelegatingHandler, które mają być wywoływane w ramach wysyłania HttpRequestMessage i odbierania HttpResponseMessage. Programy obsługi są wywoływane w sposób od góry do dołu. Oznacza to, że pierwszy wpis jest wywoływany jako pierwszy dla komunikatu żądania wychodzącego, ale ostatni dla komunikatu odpowiedzi dla ruchu przychodzącego.

Zwraca

HttpMessageHandler

Łańcuch obsługi komunikatów HTTP.

Wyjątki

ArgumentNullException

primaryHandler lub additionalHandlers jest null.

InvalidOperationException

additionalHandlers zawiera wpis null.

-lub-

DelegatingHandler.InnerHandler nie jest null. DelegatingHandler wystąpienia udostępnione HttpMessageHandlerBuilder nie mogą być ponownie używane ani buforowane.