PollyHttpClientBuilderExtensions.AddTransientHttpErrorPolicy Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
- builder
- IHttpClientBuilder
- 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.