IHttpClientBuilder Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Построитель для настройки именованных экземпляров HttpClient, возвращаемых интерфейсом IHttpClientFactory.
public interface class IHttpClientBuilderpublic interface IHttpClientBuildertype IHttpClientBuilder = interfacePublic Interface IHttpClientBuilderСвойства
| Name |
Возвращает имя клиента, настроенного этим построителем. |
| Services |
Возвращает коллекцию служб приложений. |
Методы расширения
| AddAsKeyed(IHttpClientBuilder, ServiceLifetime) |
Построитель для настройки именованных экземпляров HttpClient, возвращаемых интерфейсом IHttpClientFactory. |
| 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) |
Настраивает привязку между типом |
| AddTypedClient<TClient>(IHttpClientBuilder, Func<HttpClient,TClient>) |
Настраивает привязку между типом |
| AddTypedClient<TClient>(IHttpClientBuilder, Func<HttpClient,IServiceProvider,TClient>) |
Настраивает привязку между типом |
| AddTypedClient<TClient,TImplementation>(IHttpClientBuilder) |
Настраивает привязку между типом |
| 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, включая средства ведения журнала по умолчанию. |
| RemoveAsKeyed(IHttpClientBuilder) |
Построитель для настройки именованных экземпляров HttpClient, возвращаемых интерфейсом IHttpClientFactory. |
| 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, который будет применять при выполнении запроса политику, возвращенную интерфейсом |
| AddPolicyHandler(IHttpClientBuilder, Func<IServiceProvider,HttpRequestMessage, String,IAsyncPolicy<HttpResponseMessage>>, Func<HttpRequestMessage, String>) |
Добавляет объект , PolicyHttpMessageHandler который будет окружать выполнение запроса политикой, возвращаемой при выполнении предоставленной логики |
| AddPolicyHandler(IHttpClientBuilder, Func<HttpRequestMessage,IAsyncPolicy<HttpResponseMessage>>) |
Добавляет обработчик PolicyHttpMessageHandler, который будет применять при выполнении запроса политику, возвращенную интерфейсом |
| 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>) |
Добавляет стандартный обработчик устойчивости, который использует несколько стратегий устойчивости с параметрами по умолчанию для отправки запросов и обработки любых временных ошибок. |
