PollyHttpClientBuilderExtensions.AddTransientHttpErrorPolicy Methode

Definition

Namespace:

Microsoft.Extensions.DependencyInjection

Assembly:

Microsoft.Extensions.Http.Polly.dll

Paket:

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

Fügt eine PolicyHttpMessageHandler-Klasse hinzu, die die Anforderungsausführung mit einem Policy-Element umschließt, das durch die Ausführung des bereitgestellten Konfigurationsdelegaten erstellt wird. Der Richtliniengenerator wird so vorkonfiguriert, dass die Anwendung der Richtlinie für Anforderungen ausgelöst wird, bei denen ein vorübergehender Fehler angezeigt wird.

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

Parameter

builder

IHttpClientBuilder

Die IHttpClientBuilder.

configurePolicy

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

Ein Delegat, der zur Erstellung eines IAsyncPolicy`1-Objekts verwendet wird.

Gibt zurück

IHttpClientBuilder

Eine IHttpClientBuilder-Schnittstelle, die zum Konfigurieren des Clients verwendet werden kann.

Hinweise

Anleitungen zum Konfigurieren von Richtlinien finden Sie in den Hinweisen PolicyHttpMessageHandler zu.

Der PolicyBuilder`1 bereitgestellte für configurePolicy wurde vorkonfiguriert, um Fehler in den folgenden Kategorien zu behandeln:

• Netzwerkfehler (als HttpRequestException)
• HTTP 5XX status Codes (Serverfehler)
• HTTP 408 status Code (Anforderungstimeout)

Die von configurePolicy erstellte Richtlinie wird pro benanntem Client unbegrenzt zwischengespeichert. Richtlinien sind im Allgemeinen als Singletons konzipiert und können bei Bedarf gemeinsam genutzt werden. Wenn Sie eine Richtlinie für mehrere benannte Clients freigeben möchten, erstellen Sie zuerst die Richtlinie, und übergeben Sie sie dann wie gewünscht an mehrere Aufrufe von AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>) .