HttpMessageHandlerBuilder.CreateHandlerPipeline Methode

Definitie

Hiermee wordt een exemplaar samengesteld van HttpMessageHandler door de ene na de andere te koppelen additionalHandlers aan primaryHandler het einde van de keten. De resulterende pijplijn wordt gebruikt door IHttpClientFactory de infrastructuur voor het maken HttpClient van exemplaren met aangepaste berichthandlers. De resulterende pijplijn kan ook worden geopend met behulp IHttpMessageHandlerFactory van 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

Parameters

primaryHandler
HttpMessageHandler

Een exemplaar van HttpMessageHandler het uitvoeren onderaan de handler-keten en het verwerken van de HTTP-transportbewerkingen.

additionalHandlers
IEnumerable<DelegatingHandler>

Een geordende lijst DelegatingHandler met instanties die moeten worden aangeroepen als onderdeel van het verzenden HttpRequestMessage en ontvangen van een HttpResponseMessage. De handlers worden op een top-down manier aangeroepen. Dat wil gezegd: de eerste vermelding wordt eerst aangeroepen voor een uitgaande aanvraagbericht, maar voor het laatst voor een binnenkomend antwoordbericht.

Retouren

De HTTP-berichthandlerketen.

Uitzonderingen

primaryHandler of additionalHandlers is null.

additionalHandlers bevat een null vermelding. -of- De DelegatingHandler.InnerHandler eigenschap moet zijn null. DelegatingHandler exemplaren die zijn HttpMessageHandlerBuilder opgegeven, mogen niet opnieuw worden gebruikt of in de cache worden opgeslagen.

Van toepassing op