PollyHttpClientBuilderExtensions.AddTransientHttpErrorPolicy Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Agrega un objeto PolicyHttpMessageHandler que envolverá la ejecución de la solicitud con un objeto Policy creado mediante la ejecución del delegado de configuración proporcionado. El generador de directivas estará preconfigurado para desencadenar la aplicación de la directiva para las solicitudes que producen un error con condiciones que indican un error transitorio.
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 IHttpClientBuilderParámetros
- builder
- IHttpClientBuilder
- configurePolicy
- Func<PolicyBuilder<HttpResponseMessage>,IAsyncPolicy<HttpResponseMessage>>
Un delegado que se usa para crear una instancia de IAsyncPolicy`1.
Devoluciones
Un objeto IHttpClientBuilder que se puede usar para configurar el cliente.
Comentarios
Consulte los comentarios sobre PolicyHttpMessageHandler para obtener instrucciones sobre cómo configurar directivas.
El PolicyBuilder`1 proporcionado a configurePolicy se ha preconfigurado los errores para controlar los errores en las siguientes categorías:
- Errores de red (como HttpRequestException)
- Códigos de estado HTTP 5XX (errores de servidor)
- Código de estado HTTP 408 (tiempo de espera de solicitud)
La directiva creada por configurePolicy se almacenará en caché indefinidamente por cliente con nombre. Por lo general, las directivas están diseñadas para actuar como singletons y se pueden compartir cuando corresponda. Para compartir una directiva en varios clientes con nombre, cree primero la directiva y, a continuación, pásela a varias llamadas a AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>) como desee.
