PollyHttpClientBuilderExtensions.AddTransientHttpErrorPolicy Método

Definição

Adiciona um PolicyHttpMessageHandler que irá rodear a execução do pedido com um Policy criado ao executar o delegado de configuração fornecido. O construtor de políticas será pré-configurado para acionar a aplicação da política para pedidos 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

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

Um delegado usado para criar um IAsyncPolicy`1.

Devoluções

Um IHttpClientBuilder que pode ser usado para configurar o cliente.

Observações

Consulte as observações em PolicyHttpMessageHandler para orientações sobre a configuração de políticas.

Os PolicyBuilder`1 erros fornecidos configurePolicy foram pré-configurados para lidar com erros nas seguintes categorias:

  • Falhas de rede (como HttpRequestException)
  • Códigos de estado HTTP 5XX (erros de servidor)
  • Código de estado HTTP 408 (timeout do pedido)

A política criada por configurePolicy será armazenada em cache indefinidamente por cada cliente nomeado. As apólices são geralmente concebidas para funcionar como singletons e podem ser partilhadas quando apropriado. Para partilhar uma política entre múltiplos clientes nomeados, crie primeiro a política e depois transmita-a para várias chamadas conforme AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>) desejado.

Aplica-se a