Partilhar 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:
[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.

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