HttpMessageHandlerBuilder.CreateHandlerPipeline Methode

Definition

Erstellt eine Instanz, bei der HttpMessageHandler eine Verkettung additionalHandlers nacheinander mit primaryHandler dem Ende der Kette erfolgt. Die resultierende Pipeline wird von IHttpClientFactory der Infrastruktur verwendet, um Instanzen mit benutzerdefinierten Nachrichtenhandlern zu erstellen HttpClient . Auf die resultierende Pipeline kann auch anstelle IHttpMessageHandlerFactory von 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

Parameter

primaryHandler
HttpMessageHandler

Eine Instanz, die HttpMessageHandler unten in der Handlerkette ausgeführt werden soll und die HTTP-Transportvorgänge tatsächlich verarbeitet.

additionalHandlers
IEnumerable<DelegatingHandler>

Eine sortierte Liste von DelegatingHandler Instanzen, die als Teil des Sendens und Empfangens einer HttpRequestMessageHttpResponseMessageInstanz aufgerufen werden sollen. Die Handler werden in top-down-Weise 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

Die HTTP-Nachrichtenhandlerkette.

Ausnahmen

primaryHandler oder additionalHandlers ist null.

additionalHandlers enthält einen null Eintrag. -oder- Die DelegatingHandler.InnerHandler Eigenschaft muss sein null. DelegatingHandler Instanzen, die HttpMessageHandlerBuilder bereitgestellt werden, dürfen nicht wiederverwendet oder zwischengespeichert werden.

Gilt für: