PollyHttpClientBuilderExtensions.AddTransientHttpErrorPolicy(IHttpClientBuilder, Func<PolicyBuilder<HttpResponseMessage>,IAsyncPolicy<HttpResponseMessage>>) メソッド

定義

指定した構成デリゲートを実行して作成された Polly.Policy を含む要求の実行を囲む PolicyHttpMessageHandler を追加します。Adds a PolicyHttpMessageHandler which will surround request execution with a Polly.Policy created by executing the provided configuration delegate. ポリシー ビルダーは、一時的な障害を示す条件で失敗した要求に対して、ポリシーの適用をトリガーするように事前構成されます。The policy builder will be preconfigured to trigger application of the policy for requests that fail with conditions that indicate a transient failure.

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

パラメーター

configurePolicy
Func<Polly.PolicyBuilder<HttpResponseMessage>,Polly.IAsyncPolicy<HttpResponseMessage>>

Polly.IAsyncPolicy`1 の作成に使用されるデリゲート。A delegate used to create a Polly.IAsyncPolicy`1.

戻り値

IHttpClientBuilder

クライアントを構成するために使用できる IHttpClientBuilderAn IHttpClientBuilder that can be used to configure the client.

注釈

ポリシーの構成については、「」の「解説」を参照してください PolicyHttpMessageHandlerSee the remarks on PolicyHttpMessageHandler for guidance on configuring policies.

Polly.PolicyBuilder`1に提供されたには、次のカテゴリのエラーを configurePolicy 処理するための構成済みエラーがあります。The Polly.PolicyBuilder`1 provided to configurePolicy has been preconfigured errors to handle errors in the following categories:

  • ネットワークエラー (as HttpRequestException )Network failures (as HttpRequestException)
  • HTTP 5XX の状態コード (サーバーエラー)HTTP 5XX status codes (server errors)
  • HTTP 408 ステータスコード (要求タイムアウト)HTTP 408 status code (request timeout)

によって作成されたポリシーは、 configurePolicy 名前付きクライアントごとに無期限にキャッシュされます。The policy created by configurePolicy will be cached indefinitely per named client. 通常、ポリシーはシングルトンとして機能するように設計されており、必要に応じて共有できます。Policies are generally designed to act as singletons, and can be shared when appropriate. 複数の名前付きクライアント間でポリシーを共有するには、まずポリシーを作成し、必要に応じての複数の呼び出しに渡し AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>) ます。To share a policy across multiple named clients, first create the policy and then pass it to multiple calls to AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>) as desired.

適用対象