PollyHttpClientBuilderExtensions.AddTransientHttpErrorPolicy Método

Definição

Namespace:

Microsoft.Extensions.DependencyInjection

Assembly:

Microsoft.Extensions.Http.Polly.dll

Pacote:

Microsoft.Extensions.Http.Polly v9.0.0-preview.3.24172.13

Adiciona um PolicyHttpMessageHandler que envolverá a execução de solicitação com um Policy criado executando o delegado de configuração fornecido. O construtor de política será pré-configurado para disparar o aplicativo da política para solicitações que falham com condições que indicam uma falha transitória.

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

Parâmetros

builder

IHttpClientBuilder

O IHttpClientBuilder.

configurePolicy

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

Um delegado usado para criar um IAsyncPolicy`1.

Retornos

IHttpClientBuilder

Um IHttpClientBuilder que pode ser usado para configurar o cliente.

Comentários

Consulte as observações sobre PolicyHttpMessageHandler para obter diretrizes sobre como configurar políticas.

O PolicyBuilder`1 fornecido para configurePolicy foi pré-configurado para lidar com erros nas seguintes categorias:

• Falhas de rede (como HttpRequestException)
• Códigos de status HTTP 5XX (erros de servidor)
• Código de status HTTP 408 (tempo limite da solicitação)

A política criada por configurePolicy será armazenada em cache indefinidamente por cliente nomeado. As políticas geralmente são projetadas para atuar como singletons e podem ser compartilhadas quando apropriado. Para compartilhar uma política entre vários clientes nomeados, primeiro crie a política e, em seguida, passe-a para várias chamadas para AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>) conforme desejado.