Partager via


IHttpClientBuilder Interface

Définition

Générateur pour la configuration des instances nommées HttpClient retournées par IHttpClientFactory.

public interface class IHttpClientBuilder
public interface IHttpClientBuilder
type IHttpClientBuilder = interface
Public Interface IHttpClientBuilder

Propriétés

Nom Description
Name

Obtient le nom du client configuré par ce générateur.

Services

Obtient la collection de services d’application.

Méthodes d’extension

Nom Description
AddAsKeyed(IHttpClientBuilder, ServiceLifetime)

Inscrit un pipeline nommé HttpClient et le pipeline HttpMessageHandler de gestionnaire associé en tant que services à clé avec le nom du client comme clé et une durée de vie fournie dans le lifetime paramètre. Par défaut, la durée de vie est Scoped.

AddDefaultLogger(IHttpClientBuilder)

Ajoute la journalisation par défaut pour un nommé HttpClient, s’il a été supprimé précédemment en appelant RemoveAllLoggers(IHttpClientBuilder).

AddExtendedHttpClientLogging(IHttpClientBuilder, Action<LoggingOptions>)

Ajoute un IHttpClientAsyncLogger pour émettre des journaux pour les demandes sortantes d’un nom HttpClient.

AddExtendedHttpClientLogging(IHttpClientBuilder, IConfigurationSection)

Ajoute un IHttpClientAsyncLogger pour émettre des journaux pour les demandes sortantes d’un nom HttpClient.

AddExtendedHttpClientLogging(IHttpClientBuilder)

Ajoute un IHttpClientAsyncLogger pour émettre des journaux pour les demandes sortantes d’un nom HttpClient.

AddHttpMessageHandler(IHttpClientBuilder, Func<DelegatingHandler>)

Ajoute un délégué qui sera utilisé pour créer un gestionnaire de messages supplémentaire pour un nom HttpClient.

AddHttpMessageHandler(IHttpClientBuilder, Func<IServiceProvider,DelegatingHandler>)

Ajoute un délégué qui sera utilisé pour créer un gestionnaire de messages supplémentaire pour un nom HttpClient.

AddHttpMessageHandler<THandler>(IHttpClientBuilder)

Ajoute un gestionnaire de messages supplémentaire à partir du conteneur d’injection de dépendances pour un nom HttpClient.

AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean)

Ajoute un délégué qui sera utilisé pour créer un enregistreur d’événements supplémentaire pour un nommé HttpClient. L’enregistreur d’événements personnalisé est appelé à partir d’un gestionnaire de délégation de journalisation dédié sur chaque demande du nom correspondant HttpClient.

AddLogger<TLogger>(IHttpClientBuilder, Boolean)

Ajoute un délégué qui sera utilisé pour créer un enregistreur d’événements supplémentaire pour un nommé HttpClient. L’enregistreur d’événements personnalisé est appelé à partir d’un gestionnaire de délégation de journalisation dédié sur chaque demande du nom correspondant HttpClient.

AddPolicyHandler(IHttpClientBuilder, Func<HttpRequestMessage,IAsyncPolicy<HttpResponseMessage>>)

Ajoute un PolicyHttpMessageHandler qui entoure l’exécution de la requête avec une stratégie retournée par le policySelector.

AddPolicyHandler(IHttpClientBuilder, Func<IServiceProvider,HttpRequestMessage,IAsyncPolicy<HttpResponseMessage>>)

Ajoute un PolicyHttpMessageHandler qui entoure l’exécution de la requête avec une stratégie retournée par le policySelector.

AddPolicyHandler(IHttpClientBuilder, Func<IServiceProvider,HttpRequestMessage, String,IAsyncPolicy<HttpResponseMessage>>, Func<HttpRequestMessage, String>)

Ajoute un PolicyHttpMessageHandler qui entoure l’exécution de la requête avec une stratégie retournée en exécutant la logique keySelector de sélection de clé fournie et policyFactory.

AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>)

Ajoute un PolicyHttpMessageHandler élément qui entoure l’exécution de la requête avec le fichier fourni IAsyncPolicy`1.

AddPolicyHandlerFromRegistry(IHttpClientBuilder, Func<IReadOnlyPolicyRegistry<String>,HttpRequestMessage,IAsyncPolicy<HttpResponseMessage>>)

Ajoute un PolicyHttpMessageHandler qui entoure l’exécution de la requête avec une stratégie retournée par le IReadOnlyPolicyRegistry<TKey>.

AddPolicyHandlerFromRegistry(IHttpClientBuilder, String)

Ajoute un PolicyHttpMessageHandler qui entoure l’exécution de la requête avec une stratégie retournée par le IReadOnlyPolicyRegistry<TKey>.

AddResilienceHandler(IHttpClientBuilder, String, Action<ResiliencePipelineBuilder<HttpResponseMessage>,ResilienceHandlerContext>)

Ajoute un gestionnaire de pipeline de résilience qui utilise un pipeline de résilience inline nommé.

AddResilienceHandler(IHttpClientBuilder, String, Action<ResiliencePipelineBuilder<HttpResponseMessage>>)

Ajoute un gestionnaire de pipeline de résilience qui utilise un pipeline de résilience inline nommé.

AddStandardHedgingHandler(IHttpClientBuilder, Action<IRoutingStrategyBuilder>)

Ajoute un gestionnaire de couverture standard qui encapsule l’exécution de la requête avec un mécanisme de couverture standard.

AddStandardHedgingHandler(IHttpClientBuilder)

Ajoute un gestionnaire de couverture standard qui encapsule l’exécution de la requête avec un mécanisme de couverture standard.

AddStandardResilienceHandler(IHttpClientBuilder, Action<HttpStandardResilienceOptions>)

Ajoute un gestionnaire de résilience standard qui utilise plusieurs stratégies de résilience avec des options par défaut pour envoyer les requêtes et gérer les erreurs temporaires.

AddStandardResilienceHandler(IHttpClientBuilder, IConfigurationSection)

Ajoute un gestionnaire de résilience standard qui utilise plusieurs stratégies de résilience avec des options par défaut pour envoyer les requêtes et gérer les erreurs temporaires.

AddStandardResilienceHandler(IHttpClientBuilder)

Ajoute un gestionnaire de résilience standard qui utilise plusieurs stratégies de résilience avec des options par défaut pour envoyer les requêtes et gérer les erreurs temporaires.

AddTransientHttpErrorPolicy(IHttpClientBuilder, Func<PolicyBuilder<HttpResponseMessage>,IAsyncPolicy<HttpResponseMessage>>)

Ajoute un PolicyHttpMessageHandler élément qui entoure l’exécution de la requête avec un Policy créé en exécutant le délégué de configuration fourni. Le générateur de stratégies est préconfiguré pour déclencher l’application de la stratégie pour les demandes qui échouent avec des conditions qui indiquent un échec temporaire.

AddTypedClient<TClient,TImplementation>(IHttpClientBuilder)

Configure une liaison entre le TClient type et le nom HttpClient associé au IHttpClientBuilder. Les instances créées seront de type TImplementation.

AddTypedClient<TClient>(IHttpClientBuilder, Func<HttpClient,IServiceProvider,TClient>)

Configure une liaison entre le TClient type et le nom HttpClient associé au IHttpClientBuilder.

AddTypedClient<TClient>(IHttpClientBuilder, Func<HttpClient,TClient>)

Configure une liaison entre le TClient type et le nom HttpClient associé au IHttpClientBuilder.

AddTypedClient<TClient>(IHttpClientBuilder)

Configure une liaison entre le TClient type et le nom HttpClient associé au IHttpClientBuilder.

ConfigureAdditionalHttpMessageHandlers(IHttpClientBuilder, Action<IList<DelegatingHandler>,IServiceProvider>)

Ajoute un délégué qui sera utilisé pour configurer des gestionnaires de messages supplémentaires à l’aide HttpMessageHandlerBuilder d’un nom HttpClient.

ConfigureHttpClient(IHttpClientBuilder, Action<HttpClient>)

Ajoute un délégué utilisé pour configurer un HttpClient nommé.

ConfigureHttpClient(IHttpClientBuilder, Action<IServiceProvider,HttpClient>)

Ajoute un délégué utilisé pour configurer un HttpClient nommé.

ConfigureHttpMessageHandlerBuilder(IHttpClientBuilder, Action<HttpMessageHandlerBuilder>)
Obsolète.

Ajoute un délégué qui sera utilisé pour configurer des gestionnaires de messages à l’aide HttpMessageHandlerBuilder d’un nom HttpClient.

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Action<HttpMessageHandler,IServiceProvider>)

Ajoute un délégué qui sera utilisé pour configurer le principal HttpMessageHandler d’un nom HttpClient.

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<HttpMessageHandler>)

Ajoute un délégué qui sera utilisé pour configurer le principal HttpMessageHandler d’un nom HttpClient.

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<IServiceProvider,HttpMessageHandler>)

Ajoute un délégué qui sera utilisé pour configurer le principal HttpMessageHandler d’un nom HttpClient.

ConfigurePrimaryHttpMessageHandler<THandler>(IHttpClientBuilder)

Configure le HttpMessageHandler principal à partir du conteneur d’injection de dépendances pour un HttpClient nommé.

RedactLoggedHeaders(IHttpClientBuilder, Func<String,Boolean>)

Définit l’élément Func<T,TResult> qui détermine s’il faut réactez la valeur d’en-tête HTTP en fonction de son nom d’en-tête correspondant avant la journalisation.

RedactLoggedHeaders(IHttpClientBuilder, IEnumerable<String>)

Définit la collection d’en-têtes HTTP pour lesquelles les valeurs doivent être régérées avant la journalisation.

RemoveAllLoggers(IHttpClientBuilder)

Supprime tous les enregistreurs d’événements précédemment ajoutés pour un nom HttpClient, y compris les enregistreurs d’événements par défaut.

RemoveAllResilienceHandlers(IHttpClientBuilder)

Supprime tous les gestionnaires de résilience inscrits précédemment.

RemoveAsKeyed(IHttpClientBuilder)

Supprime les inscriptions à clé pour le nom HttpClient et HttpMessageHandler.

SetHandlerLifetime(IHttpClientBuilder, TimeSpan)

Définit la durée pendant laquelle une instance de HttpMessageHandler peut être réutilisée. Chaque client nommé peut avoir sa propre valeur de durée de vie de gestionnaire configurée. La valeur par défaut est de deux minutes. Définissez la durée de vie pour InfiniteTimeSpan désactiver l’expiration du gestionnaire.

UseSocketsHttpHandler(IHttpClientBuilder, Action<ISocketsHttpHandlerBuilder>)

Ajoute ou met à jour SocketsHttpHandler en tant que gestionnaire principal pour un nom HttpClient et le configure à l’aide ISocketsHttpHandlerBuilderde .

UseSocketsHttpHandler(IHttpClientBuilder, Action<SocketsHttpHandler,IServiceProvider>)

Ajoute ou met à jour SocketsHttpHandler en tant que gestionnaire principal pour un nom HttpClient. S’il est fourni, ajoute également un délégué qui sera utilisé pour configurer le serveur principal SocketsHttpHandler.

S’applique à