HttpMessageHandlerBuilder.CreateHandlerPipeline Metoda

Definicja

Przestrzeń nazw:

Microsoft.Extensions.Http

Zestaw:

Microsoft.Extensions.Http.dll

Pakiet:

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

Źródło:

HttpMessageHandlerBuilder.cs

Tworzy wystąpienie klasy HttpMessageHandler przez łączenie ich additionalHandlers łańcuchem primaryHandler po drugim z końcem łańcucha. Wynikowy potok jest używany przez IHttpClientFactory infrastrukturę do tworzenia HttpClient wystąpień z niestandardowymi procedurami obsługi komunikatów. Dostęp do wynikowego potoku można również uzyskać za pomocą polecenia 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 programu HttpMessageHandler do obsługi 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 elementu HttpResponseMessage. Programy obsługi są wywoływane w sposób odgórny. 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 ma wartość null.

InvalidOperationException

additionalHandlers null zawiera wpis.

-lub-

DelegatingHandler.InnerHandler nie nulljest . DelegatingHandler wystąpienia dostarczone do HttpMessageHandlerBuilder programu nie mogą być ponownie używane ani buforowane.