PollyHttpClientBuilderExtensions.AddTransientHttpErrorPolicy Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee voegt u een PolicyHttpMessageHandler aanvraaguitvoering toe met een Policy gemaakt door de opgegeven configuratiedelegen uit te voeren. De beleidsbouwer wordt vooraf geconfigureerd om de toepassing van het beleid te activeren voor aanvragen die mislukken met voorwaarden die duiden op een tijdelijke fout.
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
Parameters
- builder
- IHttpClientBuilder
- configurePolicy
- Func<PolicyBuilder<HttpResponseMessage>,IAsyncPolicy<HttpResponseMessage>>
Een gemachtigde die wordt gebruikt om een IAsyncPolicy`1.
Retouren
Een IHttpClientBuilder die kan worden gebruikt om de client te configureren.
Opmerkingen
Zie de opmerkingen PolicyHttpMessageHandler voor richtlijnen voor het configureren van beleidsregels.
De PolicyBuilder`1 opgegeven fouten configurePolicy zijn vooraf geconfigureerd voor het afhandelen van fouten in de volgende categorieƫn:
- Netwerkfouten (als HttpRequestException)
- HTTP 5XX-statuscodes (serverfouten)
- HTTP 408-statuscode (time-out van aanvraag)
Het beleid dat is gemaakt door configurePolicy , wordt voor onbepaalde tijd in de cache opgeslagen per benoemde client. Beleidsregels zijn over het algemeen ontworpen om te fungeren als singletons en kunnen indien van toepassing worden gedeeld. Als u een beleid wilt delen tussen meerdere benoemde clients, maakt u eerst het beleid en geeft u het vervolgens door aan meerdere aanroepen naar AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>) wens.