HttpMessageHandlerBuilder.CreateHandlerPipeline Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.