Partager via


HttpMessageHandlerBuilder.CreateHandlerPipeline Méthode

Définition

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.

S’applique à