IHttpClientBuilder Интерфейс

Определение

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

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

Свойства

Name

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

Services

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

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

AddDefaultLogger(IHttpClientBuilder)

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

AddHttpMessageHandler(IHttpClientBuilder, Func<IServiceProvider,DelegatingHandler>)

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

AddHttpMessageHandler(IHttpClientBuilder, Func<DelegatingHandler>)

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

AddHttpMessageHandler<THandler>(IHttpClientBuilder)

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

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

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

AddLogger<TLogger>(IHttpClientBuilder, Boolean)

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

AddTypedClient<TClient>(IHttpClientBuilder)

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

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

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

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

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

AddTypedClient<TClient,TImplementation>(IHttpClientBuilder)

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

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

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

ConfigureHttpClient(IHttpClientBuilder, Action<IServiceProvider,HttpClient>)

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

ConfigureHttpClient(IHttpClientBuilder, Action<HttpClient>)

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

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

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

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Action<HttpMessageHandler,IServiceProvider>)

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

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<IServiceProvider,HttpMessageHandler>)

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

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<HttpMessageHandler>)

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

ConfigurePrimaryHttpMessageHandler<THandler>(IHttpClientBuilder)

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

RedactLoggedHeaders(IHttpClientBuilder, IEnumerable<String>)

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

RedactLoggedHeaders(IHttpClientBuilder, Func<String,Boolean>)

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

RemoveAllLoggers(IHttpClientBuilder)

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

SetHandlerLifetime(IHttpClientBuilder, TimeSpan)

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

UseSocketsHttpHandler(IHttpClientBuilder, Action<ISocketsHttpHandlerBuilder>)

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

UseSocketsHttpHandler(IHttpClientBuilder, Action<SocketsHttpHandler,IServiceProvider>)

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

AddExtendedHttpClientLogging(IHttpClientBuilder)

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

AddExtendedHttpClientLogging(IHttpClientBuilder, IConfigurationSection)

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

AddExtendedHttpClientLogging(IHttpClientBuilder, Action<LoggingOptions>)

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

AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>)

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

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, Func<HttpRequestMessage,IAsyncPolicy<HttpResponseMessage>>)

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

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

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

AddPolicyHandlerFromRegistry(IHttpClientBuilder, String)

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

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

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

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

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

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

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

AddStandardHedgingHandler(IHttpClientBuilder)

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

AddStandardHedgingHandler(IHttpClientBuilder, Action<IRoutingStrategyBuilder>)

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

AddStandardResilienceHandler(IHttpClientBuilder)

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

AddStandardResilienceHandler(IHttpClientBuilder, IConfigurationSection)

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

AddStandardResilienceHandler(IHttpClientBuilder, Action<HttpStandardResilienceOptions>)

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

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