PollyHttpClientBuilderExtensions.AddTransientHttpErrorPolicy Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Aggiunge un oggetto PolicyHttpMessageHandler che racchiuderà l'esecuzione della richiesta in un oggetto Policy creato eseguendo il delegato di configurazione fornito. Il generatore di criteri verrà preconfigurato per attivare l'applicazione dei criteri per le richieste che non riescono con condizioni che indicano un errore temporaneo.
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
Parametri
- builder
- IHttpClientBuilder
Oggetto IHttpClientBuilder.
- configurePolicy
- Func<PolicyBuilder<HttpResponseMessage>,IAsyncPolicy<HttpResponseMessage>>
Delegato usato per creare IAsyncPolicy`1.
Restituisce
Oggetto IHttpClientBuilder che è possibile usare per configurare il client.
Commenti
Per indicazioni sulla configurazione dei criteri, vedere le osservazioni.PolicyHttpMessageHandler
Gli PolicyBuilder`1 errori forniti per configurePolicy
sono stati preconfigurati per gestire gli errori nelle categorie seguenti:
- Errori di rete (come HttpRequestException)
- Codici di stato HTTP 5XX (errori del server)
- Codice di stato HTTP 408 (timeout richiesta)
I criteri creati da verranno memorizzati configurePolicy
nella cache indefinitamente per ogni client denominato. I criteri sono generalmente progettati per fungere da singleton e possono essere condivisi quando necessario. Per condividere un criterio in più client denominati, creare prima il criterio e quindi passarlo a più chiamate a AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>) come desiderato.