HttpMessageHandlerBuilder.CreateHandlerPipeline Methode

Definition

Namespace:

Microsoft.Extensions.Http

Assembly:

Microsoft.Extensions.Http.dll

Paket:

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

Quelle:

HttpMessageHandlerBuilder.cs

Erstellt eine instance vonHttpMessageHandler, indem eine nach der anderen mit primaryHandler am Ende der Kette verkettet additionalHandlers wird. Die resultierende Pipeline wird von der IHttpClientFactory Infrastruktur verwendet, um Instanzen mit benutzerdefinierten Nachrichtenhandlern zu erstellen HttpClient . Auf die resultierende Pipeline kann auch mit IHttpMessageHandlerFactory anstelle von IHttpClientFactoryzugegriffen werden.

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

Parameter

primaryHandler

HttpMessageHandler

Ein instance vonHttpMessageHandler, um am unteren Rand der Handlerkette zu arbeiten und die HTTP-Transportvorgänge tatsächlich zu behandeln.

additionalHandlers

IEnumerable<DelegatingHandler>

Eine geordnete Liste von DelegatingHandler Instanzen, die beim Senden und Empfangen eines HttpRequestMessageHttpResponseMessageaufgerufen werden sollen. Die Handler werden von oben nach unten aufgerufen. Das heißt, der erste Eintrag wird zuerst für eine ausgehende Anforderungsnachricht aufgerufen, aber zuletzt für eine eingehende Antwortnachricht.

Gibt zurück

HttpMessageHandler

Die HTTP-Nachrichtenhandlerkette.

Ausnahmen

ArgumentNullException

primaryHandler oder additionalHandlers ist null.

InvalidOperationException

additionalHandlers enthält einen null Eintrag.

- oder -

DelegatingHandler.InnerHandler ist nicht null. DelegatingHandler Für bereitgestellte HttpMessageHandlerBuilder Instanzen dürfen nicht wiederverwendet oder zwischengespeichert werden.