PollyHttpClientBuilderExtensions.AddTransientHttpErrorPolicy Méthode

Définition

Ajoute un PolicyHttpMessageHandler qui entoure l’exécution de la requête avec un Policy qui est créé en exécutant le délégué de configuration fourni. Le générateur de stratégies est préconfiguré pour déclencher l’application de la stratégie aux requêtes qui échouent dans des conditions indiquant un échec temporaire.

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

Paramètres

builder
IHttpClientBuilder

L’IHttpClientBuilderopérateur

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

Délégué permettant de créer un IAsyncPolicy`1.

Retours

IHttpClientBuilder qui peut être utilisé pour configurer le client.

Remarques

Consultez les remarques sur PolicyHttpMessageHandler pour obtenir des conseils sur la configuration des stratégies.

Le PolicyBuilder`1 fourni à configurePolicy a été préconfiguré erreurs pour gérer les erreurs dans les catégories suivantes :

  • Échecs réseau (en tant que HttpRequestException)
  • Codes status HTTP 5XX (erreurs de serveur)
  • Code status HTTP 408 (délai d’expiration de la demande)

La stratégie créée par configurePolicy sera mise en cache indéfiniment par client nommé. Les stratégies sont généralement conçues pour agir en tant que singletons et peuvent être partagées le cas échéant. Pour partager une stratégie entre plusieurs clients nommés, créez d’abord la stratégie, puis passez-la à plusieurs appels à AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>) comme vous le souhaitez.

S’applique à