IHttpClientBuilder Interface

Definição

Um construtor para configurar instâncias nomeadas HttpClient devolvido por IHttpClientFactory.

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

Propriedades

Name Description
Name

Obtém o nome do cliente configurado por este construtor.

Services

Recebe a recolha do serviço de aplicação.

Métodos da Extensão

Name Description
AddAsKeyed(IHttpClientBuilder, ServiceLifetime)

Regista um pipeline HttpMessageHandler handler nomeado HttpClient e o handler relacionado como serviços com chave, com o nome do cliente como chave, e uma vida útil fornecida no lifetime parâmetro. Por defeito, a vida útil é Scoped.

AddDefaultLogger(IHttpClientBuilder)

Adiciona novamente o registo predefinido para um nome HttpClient, se foi removido anteriormente ao chamar RemoveAllLoggers(IHttpClientBuilder).

AddExtendedHttpClientLogging(IHttpClientBuilder, Action<LoggingOptions>, Boolean)

Adiciona um IHttpClientAsyncLogger para emitir logs para pedidos de saída para um nome HttpClient.

AddExtendedHttpClientLogging(IHttpClientBuilder, Action<LoggingOptions>)

Adiciona um IHttpClientAsyncLogger para emitir logs para pedidos de saída para um nome HttpClient.

AddExtendedHttpClientLogging(IHttpClientBuilder, Boolean)

Adiciona um IHttpClientAsyncLogger para emitir logs para pedidos de saída para um nome HttpClient.

AddExtendedHttpClientLogging(IHttpClientBuilder, IConfigurationSection, Boolean)

Adiciona um IHttpClientAsyncLogger para emitir logs para pedidos de saída para um nome HttpClient.

AddExtendedHttpClientLogging(IHttpClientBuilder, IConfigurationSection)

Adiciona um IHttpClientAsyncLogger para emitir logs para pedidos de saída para um nome HttpClient.

AddExtendedHttpClientLogging(IHttpClientBuilder)

Adiciona um IHttpClientAsyncLogger para emitir logs para pedidos de saída para um nome HttpClient.

AddHttpMessageHandler(IHttpClientBuilder, Func<DelegatingHandler>)

Adiciona um delegado que será usado para criar um manipulador de mensagens adicional para um HttpClient.

AddHttpMessageHandler(IHttpClientBuilder, Func<IServiceProvider,DelegatingHandler>)

Adiciona um delegado que será usado para criar um manipulador de mensagens adicional para um HttpClient.

AddHttpMessageHandler<THandler>(IHttpClientBuilder)

Adiciona um manipulador de mensagens adicional do contentor de injeção de dependências para um .HttpClient

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

Adiciona um delegado que será usado para criar um logger adicional para um .HttpClient O logger personalizado seria invocado a partir de um DelegatingHandler dedicado para registos em cada pedido do correspondente nome HttpClient.

AddLogger<TLogger>(IHttpClientBuilder, Boolean)

Adiciona um delegado que será usado para criar um logger adicional para um .HttpClient O logger personalizado seria invocado a partir de um DelegatingHandler dedicado para registos em cada pedido do correspondente nome HttpClient.

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

Adiciona um PolicyHttpMessageHandler que vai rodear a execução do pedido com uma política devolvida pelo policySelector.

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

Adiciona um PolicyHttpMessageHandler que vai rodear a execução do pedido com uma política devolvida pelo policySelector.

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

Adiciona a PolicyHttpMessageHandler que rodeará a execução do pedido com uma política devolvida executando a lógica keySelector de seleção de chaves fornecida e policyFactory.

AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>)

Adiciona um PolicyHttpMessageHandler que irá rodear a execução do pedido com o fornecido IAsyncPolicy`1.

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

Adiciona um PolicyHttpMessageHandler que vai rodear a execução do pedido com uma política devolvida pelo IReadOnlyPolicyRegistry<TKey>.

AddPolicyHandlerFromRegistry(IHttpClientBuilder, String)

Adiciona um PolicyHttpMessageHandler que vai rodear a execução do pedido com uma política devolvida pelo IReadOnlyPolicyRegistry<TKey>.

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

Adiciona um handler de pipeline de resiliência que utiliza um pipeline de resiliência inline nomeado.

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

Adiciona um handler de pipeline de resiliência que utiliza um pipeline de resiliência inline nomeado.

AddStandardHedgingHandler(IHttpClientBuilder, Action<IRoutingStrategyBuilder>)

Adiciona um handler de cobertura padrão que envolve a execução do pedido com um mecanismo de cobertura padrão.

AddStandardHedgingHandler(IHttpClientBuilder)

Adiciona um handler de cobertura padrão que envolve a execução do pedido com um mecanismo de cobertura padrão.

AddStandardResilienceHandler(IHttpClientBuilder, Action<HttpStandardResilienceOptions>)

Adiciona um handler de resiliência padrão que utiliza múltiplas estratégias de resiliência com opções padrão para enviar os pedidos e lidar com quaisquer erros transitórios.

AddStandardResilienceHandler(IHttpClientBuilder, IConfigurationSection)

Adiciona um handler de resiliência padrão que utiliza múltiplas estratégias de resiliência com opções padrão para enviar os pedidos e lidar com quaisquer erros transitórios.

AddStandardResilienceHandler(IHttpClientBuilder)

Adiciona um handler de resiliência padrão que utiliza múltiplas estratégias de resiliência com opções padrão para enviar os pedidos e lidar com quaisquer erros transitórios.

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

Adiciona um PolicyHttpMessageHandler que irá rodear a execução do pedido com um Policy criado ao executar o delegado de configuração fornecido. O construtor de políticas será pré-configurado para acionar a aplicação da política para pedidos que falham com condições que indicam uma falha transitória.

AddTypedClient<TClient,TImplementation>(IHttpClientBuilder)

Configura uma ligação entre o TClient tipo e o nome HttpClient associado ao IHttpClientBuilder. As instâncias criadas serão do tipo TImplementation.

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

Configura uma ligação entre o TClient tipo e o nome HttpClient associado ao IHttpClientBuilder.

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

Configura uma ligação entre o TClient tipo e o nome HttpClient associado ao IHttpClientBuilder.

AddTypedClient<TClient>(IHttpClientBuilder)

Configura uma ligação entre o TClient tipo e o nome HttpClient associado ao IHttpClientBuilder.

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

Adiciona um delegado que será usado para configurar manipuladores de mensagens adicionais usando HttpMessageHandlerBuilder para um .HttpClient

ConfigureHttpClient(IHttpClientBuilder, Action<HttpClient>)

Adiciona um delegado que será usado para configurar uma configuração nomeada HttpClient.

ConfigureHttpClient(IHttpClientBuilder, Action<IServiceProvider,HttpClient>)

Adiciona um delegado que será usado para configurar uma configuração nomeada HttpClient.

ConfigureHttpMessageHandlerBuilder(IHttpClientBuilder, Action<HttpMessageHandlerBuilder>)
Obsoleto.

Adiciona um delegado que será usado para configurar manipuladores de mensagens usando HttpMessageHandlerBuilder para um .HttpClient

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Action<HttpMessageHandler,IServiceProvider>)

Adiciona um delegado que será usado para configurar o primário HttpMessageHandler para um nome HttpClient.

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<HttpMessageHandler>)

Adiciona um delegado que será usado para configurar o primário HttpMessageHandler para um nome HttpClient.

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<IServiceProvider,HttpMessageHandler>)

Adiciona um delegado que será usado para configurar o primário HttpMessageHandler para um nome HttpClient.

ConfigurePrimaryHttpMessageHandler<THandler>(IHttpClientBuilder)

Configura o componente principal HttpMessageHandler do contentor de injeção de dependência para um componente nomeado HttpClient.

RedactLoggedHeaders(IHttpClientBuilder, Func<String,Boolean>)

Define o Func<T,TResult> que determina se deve redigir o valor do cabeçalho HTTP dado o respetivo nome do cabeçalho antes de registar.

RedactLoggedHeaders(IHttpClientBuilder, IEnumerable<String>)

Define a coleção de nomes de cabeçalhos HTTP para quais valores devem ser redigidos antes de registar.

RemoveAllLoggers(IHttpClientBuilder)

Remove todos os loggers previamente adicionados para um nome HttpClient, incluindo os padrão.

RemoveAllResilienceHandlers(IHttpClientBuilder)

Remove todos os manipuladores de resiliência registados anteriormente.

RemoveAsKeyed(IHttpClientBuilder)

Remove os registos com chave para os nomeados HttpClient e HttpMessageHandler.

SetHandlerLifetime(IHttpClientBuilder, TimeSpan)

Define o período de tempo durante o qual uma HttpMessageHandler instância pode ser reutilizada. Cada cliente nomeado pode ter seu próprio valor de vida útil do manipulador configurado. O valor padrão é dois minutos. Defina o tempo de vida para InfiniteTimeSpan desativar a expiração do handler.

UseSocketsHttpHandler(IHttpClientBuilder, Action<ISocketsHttpHandlerBuilder>)

Adiciona ou atualiza SocketsHttpHandler como gestor primário para um nome HttpClient e configura-o usando ISocketsHttpHandlerBuilder.

UseSocketsHttpHandler(IHttpClientBuilder, Action<SocketsHttpHandler,IServiceProvider>)

Adiciona ou atualiza SocketsHttpHandler como tratador principal para um nome HttpClient. Se for fornecido, também adiciona um delegado que será usado para configurar o principal SocketsHttpHandler.

Aplica-se a