PollyHttpClientBuilderExtensions.AddTransientHttpErrorPolicy Метод

Определение

Пространство имен:
Microsoft.Extensions.DependencyInjection
Сборка:
Microsoft.Extensions.Http.Polly.dll
Пакет:
Microsoft.Extensions.Http.Polly v11.0.0-preview.5.26302.115

Добавляет объект 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

Объект IHttpClientBuilder.

configurePolicy
Func<PolicyBuilder<HttpResponseMessage>,IAsyncPolicy<HttpResponseMessage>>

Делегат, используемый IAsyncPolicy`1для создания .

Возвращаемое значение

IHttpClientBuilder

Можно IHttpClientBuilder использовать для настройки клиента.

Комментарии

См. замечания по PolicyHttpMessageHandler настройке политик.

PolicyBuilder`1 Предоставленные configurePolicy ошибки были предварительно настроены для обработки ошибок в следующих категориях:

  • Сбои сети (как HttpRequestException)
  • Коды состояния HTTP 5XX (ошибки сервера)
  • Код состояния HTTP 408 (время ожидания запроса)

Политика, созданная с configurePolicy помощью, будет кэширована на неопределенный срок на именованный клиент. Политики, как правило, предназначены для использования в качестве одноэлементных и могут совместно использоваться при необходимости. Чтобы предоставить общий доступ к политике нескольким именованным клиентам, сначала создайте политику, а затем передайте ее в несколько вызовов по AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>) мере необходимости.

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