HttpMessageHandlerBuilder.CreateHandlerPipeline Méthode

Définition

Espace de noms:

Microsoft.Extensions.Http

Assembly:

Microsoft.Extensions.Http.dll

Paquet:

Microsoft.Extensions.Http v9.0.0-preview.6.24327.7

Source:

HttpMessageHandlerBuilder.cs

Construit un instance de HttpMessageHandler en chaînant additionalHandlers l’un après l’autre avec primaryHandler en fin de chaîne. Le pipeline résultant est utilisé par IHttpClientFactory l’infrastructure pour créer HttpClient des instances 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

Une instance de HttpMessageHandler pour fonctionner au 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 haut en bas. Autrement dit, la première entrée est appelée d’abord pour un message de demande sortante, mais la dernière pour un message de réponse entrant.

Retours

HttpMessageHandler

Chaîne de gestionnaire de messages HTTP.

Exceptions

ArgumentNullException

primaryHandler ou additionalHandlers est null.

InvalidOperationException

additionalHandlers contient une null entrée.

- ou -

DelegatingHandler.InnerHandler n’est pas un null. DelegatingHandler les instances fournies à HttpMessageHandlerBuilder ne doivent pas être réutilisées ou mises en cache.