Ler em inglês

Compartilhar via


PollyHttpClientBuilderExtensions.AddTransientHttpErrorPolicy Método

Definição

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 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);

Parâmetros

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

Um delegado usado para criar um IAsyncPolicy`1.

Retornos

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.

Aplica-se a

Produto Versões
.NET Standard 2.0 (package-provided)