PollyHttpClientBuilderExtensions.AddTransientHttpErrorPolicy Метод

  • Ссылка

Определение

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

Добавляет обработчик 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>) по желанию.

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