HttpMessageHandlerBuilder.CreateHandlerPipeline Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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.