PollyHttpClientBuilderExtensions.AddTransientHttpErrorPolicy Método

Definición

Espacio de nombres:

Microsoft.Extensions.DependencyInjection

Ensamblado:

Microsoft.Extensions.Http.Polly.dll

Paquete:

Microsoft.Extensions.Http.Polly v9.0.0-preview.3.24172.13

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 IHttpClientBuilder

Parámetros

builder

IHttpClientBuilder

IHttpClientBuilder.

configurePolicy

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

Un delegado que se usa para crear una instancia de IAsyncPolicy`1.

Devoluciones

IHttpClientBuilder

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.