PollyHttpClientBuilderExtensions.AddTransientHttpErrorPolicy Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.Extensions.DependencyInjection

Zestaw:: Microsoft.Extensions.Http.Polly.dll

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

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Dodaje obiekt PolicyHttpMessageHandler , który będzie otaczać wykonywanie żądań utworzonym Policy przez wykonanie dostarczonego delegata konfiguracji. Konstruktor zasad zostanie wstępnie skonfigurowany, aby wyzwolić stosowanie zasad dla żądań, które kończą się niepowodzeniem z warunkami wskazującymi błąd przejściowy.

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

Parametry

builder: IHttpClientBuilder

Element IHttpClientBuilder.

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

Delegat użyty do utworzenia elementu IAsyncPolicy`1.

Zwraca

IHttpClientBuilder

Element IHttpClientBuilder , którego można użyć do skonfigurowania klienta.

Uwagi

Zapoznaj się z uwagami dotyczącymi PolicyHttpMessageHandler konfigurowania zasad, aby uzyskać wskazówki.

Podane PolicyBuilder`1 polecenie configurePolicy zostało wstępnie skonfigurowane błędy do obsługi błędów w następujących kategoriach:

Błędy sieci (jako HttpRequestException)
Kody stanu HTTP 5XX (błędy serwera)
Kod stanu HTTP 408 (limit czasu żądania)

Zasady utworzone przez configurePolicy program będą buforowane na czas nieokreślony dla nazwanego klienta. Zasady są zazwyczaj przeznaczone do działania jako singletony i mogą być udostępniane w razie potrzeby. Aby udostępnić zasady wielu nazwanych klientów, najpierw utwórz zasady, a następnie przekaż je do wielu wywołań zgodnie AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>) z potrzebami.

Dotyczy