PollyHttpClientBuilderExtensions.AddTransientHttpErrorPolicy Méthode

Référence

Définition

Espace de noms:: Microsoft.Extensions.DependencyInjection

Assembly:: Microsoft.Extensions.Http.Polly.dll

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

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

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 à