PollyHttpClientBuilderExtensions.AddTransientHttpErrorPolicy Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет обработчик PolicyHttpMessageHandler, который будет применять при выполнении запроса политику Policy, созданную путем выполнения предоставленного делегата конфигурации. Построитель политики будет предварительно настроен для применения политики к запросам, завершившимся сбоем из-за временной ошибки.
public:
[System::Runtime::CompilerServices::Extension]
static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ AddTransientHttpErrorPolicy(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder, Func<Polly::PolicyBuilder<System::Net::Http::HttpResponseMessage ^> ^, Polly::IAsyncPolicy<System::Net::Http::HttpResponseMessage ^> ^> ^ configurePolicy);
public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddTransientHttpErrorPolicy (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, Func<Polly.PolicyBuilder<System.Net.Http.HttpResponseMessage>,Polly.IAsyncPolicy<System.Net.Http.HttpResponseMessage>> configurePolicy);
static member AddTransientHttpErrorPolicy : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * Func<Polly.PolicyBuilder<System.Net.Http.HttpResponseMessage>, Polly.IAsyncPolicy<System.Net.Http.HttpResponseMessage>> -> Microsoft.Extensions.DependencyInjection.IHttpClientBuilder
<Extension()>
Public Function AddTransientHttpErrorPolicy (builder As IHttpClientBuilder, configurePolicy As Func(Of PolicyBuilder(Of HttpResponseMessage), IAsyncPolicy(Of HttpResponseMessage))) As IHttpClientBuilder
Параметры
- builder
- IHttpClientBuilder
- configurePolicy
- Func<PolicyBuilder<HttpResponseMessage>,IAsyncPolicy<HttpResponseMessage>>
Делегат, используемый для создания IAsyncPolicy`1.
Возвращаемое значение
Интерфейс IHttpClientBuilder, который можно использовать для настройки клиента.
Комментарии
Рекомендации по настройке политик см. в примечаниях PolicyHttpMessageHandler .
Предоставленный PolicyBuilder`1 объект имеет configurePolicy
предварительно настроенные ошибки для обработки ошибок в следующих категориях:
- Сбои сети (как HttpRequestException)
- Коды состояния HTTP 5XX (ошибки сервера)
- Код состояния HTTP 408 (время ожидания запроса)
Политика, созданная , configurePolicy
будет кэшироваться на неопределенный срок для каждого именованного клиента. Политики обычно предназначены для работы в качестве одноэлементных объектов и могут совместно использоваться при необходимости. Чтобы совместно использовать политику для нескольких именованных клиентов, сначала создайте политику, а затем передайте ее нескольким вызовам AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>) по желанию.