HttpMessageHandlerBuilder.CreateHandlerPipeline Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Construit une instance de HttpMessageHandler en chaînant additionalHandlers
l’un après l’autre avec primaryHandler
à la fin de la chaîne. Le pipeline résultant est utilisé par IHttpClientFactory infrastructure pour créer des instances HttpClient avec des gestionnaires de messages personnalisés. Le pipeline résultant est également accessible à l’aide de IHttpMessageHandlerFactory au lieu de 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
Paramètres
- primaryHandler
- HttpMessageHandler
Instance de HttpMessageHandler pour fonctionner en bas de la chaîne de gestionnaires et gérer réellement les opérations de transport HTTP.
- additionalHandlers
- IEnumerable<DelegatingHandler>
Liste ordonnée d’instances DelegatingHandler à appeler dans le cadre de l’envoi d’un HttpRequestMessage et de la réception d’un HttpResponseMessage. Les gestionnaires sont appelés de manière top-down. Autrement dit, la première entrée est appelée en premier pour un message de demande sortante, mais dernière pour un message de réponse entrant.
Retours
Chaîne de gestionnaires de messages HTTP.
Exceptions
primaryHandler
ou additionalHandlers
est null
.
additionalHandlers
contient une entrée de null
.
-ou-
DelegatingHandler.InnerHandler
n’est pas null
.
DelegatingHandler
instances fournies à HttpMessageHandlerBuilder
ne doivent pas être réutilisées ou mises en cache.