Поделиться через


IHttpClientBuilder Интерфейс

Определение

Построитель для настройки именованных HttpClient экземпляров, возвращенных IHttpClientFactory.

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

Свойства

Имя Описание
Name

Возвращает имя клиента, настроенного этим построителем.

Services

Возвращает коллекцию служб приложений.

Методы расширения

Имя Описание
AddAsKeyed(IHttpClientBuilder, ServiceLifetime)

Регистрирует именованный HttpClient и связанный конвейер HttpMessageHandler обработчика в качестве ключей служб с именем клиента в качестве ключа и время существования, предоставленное в параметре lifetime . По умолчанию время существования равно Scoped.

AddDefaultLogger(IHttpClientBuilder)

Добавляет журнал по умолчанию для именованного HttpClient, если он был удален ранее путем вызова RemoveAllLoggers(IHttpClientBuilder).

AddExtendedHttpClientLogging(IHttpClientBuilder, Action<LoggingOptions>)

IHttpClientAsyncLogger Добавляет журналы для исходящих запросов для именованногоHttpClient.

AddExtendedHttpClientLogging(IHttpClientBuilder, IConfigurationSection)

IHttpClientAsyncLogger Добавляет журналы для исходящих запросов для именованногоHttpClient.

AddExtendedHttpClientLogging(IHttpClientBuilder)

IHttpClientAsyncLogger Добавляет журналы для исходящих запросов для именованногоHttpClient.

AddHttpMessageHandler(IHttpClientBuilder, Func<DelegatingHandler>)

Добавляет делегат, который будет использоваться для создания дополнительного обработчика сообщений для именованного HttpClient.

AddHttpMessageHandler(IHttpClientBuilder, Func<IServiceProvider,DelegatingHandler>)

Добавляет делегат, который будет использоваться для создания дополнительного обработчика сообщений для именованного HttpClient.

AddHttpMessageHandler<THandler>(IHttpClientBuilder)

Добавляет дополнительный обработчик сообщений из контейнера внедрения зависимостей для именованного HttpClient.

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

Добавляет делегат, который будет использоваться для создания дополнительного средства ведения журнала для именованного HttpClient. Пользовательский средство ведения журнала будет вызываться из выделенного журнала DelegatingHandler по каждому запросу соответствующего имени HttpClient.

AddLogger<TLogger>(IHttpClientBuilder, Boolean)

Добавляет делегат, который будет использоваться для создания дополнительного средства ведения журнала для именованного HttpClient. Пользовательский средство ведения журнала будет вызываться из выделенного журнала DelegatingHandler по каждому запросу соответствующего имени HttpClient.

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

Добавляет объект PolicyHttpMessageHandler , который будет окружать выполнение запроса политикой, возвращаемой параметром policySelector.

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

Добавляет объект PolicyHttpMessageHandler , который будет окружать выполнение запроса политикой, возвращаемой параметром policySelector.

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

Добавляет объект PolicyHttpMessageHandler , который будет окружать выполнение запроса политикой, возвращаемой путем выполнения предоставленной логики keySelector выбора ключа и policyFactory.

AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>)

Добавляет объект PolicyHttpMessageHandler , который будет окружать выполнение запроса предоставленным IAsyncPolicy`1.

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

Добавляет объект PolicyHttpMessageHandler , который будет окружать выполнение запроса политикой, возвращаемой параметром IReadOnlyPolicyRegistry<TKey>.

AddPolicyHandlerFromRegistry(IHttpClientBuilder, String)

Добавляет объект PolicyHttpMessageHandler , который будет окружать выполнение запроса политикой, возвращаемой параметром IReadOnlyPolicyRegistry<TKey>.

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

Добавляет обработчик конвейера устойчивости, использующий именованный конвейер устойчивости.

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

Добавляет обработчик конвейера устойчивости, использующий именованный конвейер устойчивости.

AddStandardHedgingHandler(IHttpClientBuilder, Action<IRoutingStrategyBuilder>)

Добавляет стандартный обработчик хеджирования, который упаковывает выполнение запроса с помощью стандартного механизма хеджирования.

AddStandardHedgingHandler(IHttpClientBuilder)

Добавляет стандартный обработчик хеджирования, который упаковывает выполнение запроса с помощью стандартного механизма хеджирования.

AddStandardResilienceHandler(IHttpClientBuilder, Action<HttpStandardResilienceOptions>)

Добавляет стандартный обработчик устойчивости, который использует несколько стратегий устойчивости с параметрами по умолчанию для отправки запросов и обработки временных ошибок.

AddStandardResilienceHandler(IHttpClientBuilder, IConfigurationSection)

Добавляет стандартный обработчик устойчивости, который использует несколько стратегий устойчивости с параметрами по умолчанию для отправки запросов и обработки временных ошибок.

AddStandardResilienceHandler(IHttpClientBuilder)

Добавляет стандартный обработчик устойчивости, который использует несколько стратегий устойчивости с параметрами по умолчанию для отправки запросов и обработки временных ошибок.

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

Добавляет объект PolicyHttpMessageHandler , который будет окружать выполнение запроса с Policy созданным путем выполнения предоставленного делегата конфигурации. Построитель политик будет предварительно настроен для активации приложения политики для запросов, которые завершаются сбоем с условиями, указывающими на временный сбой.

AddTypedClient<TClient,TImplementation>(IHttpClientBuilder)

Настраивает привязку между TClient типом и именованным HttpClient , связанным с IHttpClientBuilderним. Созданные экземпляры будут иметь тип TImplementation.

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

Настраивает привязку между TClient типом и именованным HttpClient , связанным с IHttpClientBuilderним.

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

Настраивает привязку между TClient типом и именованным HttpClient , связанным с IHttpClientBuilderним.

AddTypedClient<TClient>(IHttpClientBuilder)

Настраивает привязку между TClient типом и именованным HttpClient , связанным с IHttpClientBuilderним.

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

Добавляет делегат, который будет использоваться для настройки дополнительных обработчиков сообщений, используемых HttpMessageHandlerBuilder для именованного HttpClient.

ConfigureHttpClient(IHttpClientBuilder, Action<HttpClient>)

Добавляет делегат, который будет использоваться для настройки именованного HttpClient.

ConfigureHttpClient(IHttpClientBuilder, Action<IServiceProvider,HttpClient>)

Добавляет делегат, который будет использоваться для настройки именованного HttpClient.

ConfigureHttpMessageHandlerBuilder(IHttpClientBuilder, Action<HttpMessageHandlerBuilder>)
Устаревшие..

Добавляет делегат, который будет использоваться для настройки обработчиков сообщений с помощью HttpMessageHandlerBuilder именованного.HttpClient

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Action<HttpMessageHandler,IServiceProvider>)

Добавляет делегат, который будет использоваться для настройки основного HttpMessageHandler для именованного HttpClient.

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<HttpMessageHandler>)

Добавляет делегат, который будет использоваться для настройки основного HttpMessageHandler для именованного HttpClient.

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<IServiceProvider,HttpMessageHandler>)

Добавляет делегат, который будет использоваться для настройки основного HttpMessageHandler для именованного HttpClient.

ConfigurePrimaryHttpMessageHandler<THandler>(IHttpClientBuilder)

Настраивает основной HttpMessageHandler из контейнера внедрения зависимостей для именованного компонента HttpClient.

RedactLoggedHeaders(IHttpClientBuilder, Func<String,Boolean>)

Задает значение, определяющее Func<T,TResult> , следует ли изменить значение заголовка HTTP с соответствующим именем заголовка перед ведением журнала.

RedactLoggedHeaders(IHttpClientBuilder, IEnumerable<String>)

Задает коллекцию имен заголовков HTTP, для которых следует отредактировать значения перед ведением журнала.

RemoveAllLoggers(IHttpClientBuilder)

Удаляет все ранее добавленные средства ведения журнала для именованного HttpClient, включая имена по умолчанию.

RemoveAllResilienceHandlers(IHttpClientBuilder)

Удаляет все обработчики устойчивости, зарегистрированные ранее.

RemoveAsKeyed(IHttpClientBuilder)

Удаляет ключи регистрации именованных HttpClient и HttpMessageHandler.

SetHandlerLifetime(IHttpClientBuilder, TimeSpan)

Задает период времени, в течение которого экземпляр HttpMessageHandler может использоваться повторно. Для каждого именованного клиента можно задать собственное значение времени жизни обработчика. Значение по умолчанию — две минуты. Задайте время существования, чтобы InfiniteTimeSpan отключить срок действия обработчика.

UseSocketsHttpHandler(IHttpClientBuilder, Action<ISocketsHttpHandlerBuilder>)

Добавляет или обновляется SocketsHttpHandler в качестве основного обработчика именованного HttpClient и настраивает его с помощью ISocketsHttpHandlerBuilder.

UseSocketsHttpHandler(IHttpClientBuilder, Action<SocketsHttpHandler,IServiceProvider>)

Добавляет или обновляется SocketsHttpHandler в качестве основного обработчика именованного.HttpClient При условии также добавляет делегат, который будет использоваться для настройки основного SocketsHttpHandler.

Применяется к