HttpClientBuilderExtensions.AddLogger メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 名前 | 説明 |
|---|---|
| AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean) |
名前付き HttpClientの追加ロガーを作成するために使用されるデリゲートを追加します。 カスタム ロガーは、対応する名前付き HttpClientのすべての要求で、専用のログ DelegatingHandler から呼び出されます。 |
| AddLogger<TLogger>(IHttpClientBuilder, Boolean) |
名前付き HttpClientの追加ロガーを作成するために使用されるデリゲートを追加します。 カスタム ロガーは、対応する名前付き HttpClientのすべての要求で、専用のログ DelegatingHandler から呼び出されます。 |
AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean)
名前付き HttpClientの追加ロガーを作成するために使用されるデリゲートを追加します。 カスタム ロガーは、対応する名前付き HttpClientのすべての要求で、専用のログ DelegatingHandler から呼び出されます。
public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddLogger(this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, Func<IServiceProvider,Microsoft.Extensions.Http.Logging.IHttpClientLogger> httpClientLoggerFactory, bool wrapHandlersPipeline = false);static member AddLogger : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * Func<IServiceProvider, Microsoft.Extensions.Http.Logging.IHttpClientLogger> * bool -> Microsoft.Extensions.DependencyInjection.IHttpClientBuilder<Extension()>
Public Function AddLogger (builder As IHttpClientBuilder, httpClientLoggerFactory As Func(Of IServiceProvider, IHttpClientLogger), Optional wrapHandlersPipeline As Boolean = false) As IHttpClientBuilderパラメーター
- builder
- IHttpClientBuilder
- httpClientLoggerFactory
- Func<IServiceProvider,IHttpClientLogger>
カスタム ロガーの作成に使用されるデリゲート。 ロガーは、 IHttpClientLogger または IHttpClientAsyncLoggerを実装する必要があります。
- wrapHandlersPipeline
- Boolean
カスタム ロガーを含むログ ハンドラーを追加ハンドラー チェーンの上部または下部に追加するかどうか。
返品
クライアントの構成に使用できる IHttpClientBuilder 。
注釈
wrapHandlersPipelineが 'true' の場合、LogRequestStart(HttpRequestMessage)とLogRequestStartAsync(HttpRequestMessage, CancellationToken)はチェーン内の他のすべてのハンドラーの前に実行されます。
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) と LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) は、他のすべての追加ハンドラーの後に実行され、基本的にパイプライン全体がラップされます。
wrapHandlersPipelineが 'false' の場合、LogRequestStart(HttpRequestMessage)とLogRequestStartAsync(HttpRequestMessage, CancellationToken)は、チェーン内の他のすべての追加ハンドラーの直後、プライマリ ハンドラーの直前に実行されます。
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan)
LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken)は、他のすべての追加ハンドラーの前、プライマリ ハンドラーの直後に実行されます。
httpClientLoggerFactoryに提供されるIServiceProvider引数は、構築されるハンドラー チェーンの有効期間を共有するスコープ付きサービス プロバイダーへの参照になります。
AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean)が複数回呼び出されると、複数のロガーが追加されます。 AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean)を呼び出す前にRemoveAllLoggers(IHttpClientBuilder)が呼び出されなかった場合は、既定のロガーに加えて新しいロガーが追加されます。
適用対象
AddLogger<TLogger>(IHttpClientBuilder, Boolean)
名前付き HttpClientの追加ロガーを作成するために使用されるデリゲートを追加します。 カスタム ロガーは、対応する名前付き HttpClientのすべての要求で、専用のログ DelegatingHandler から呼び出されます。
public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddLogger<TLogger>(this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, bool wrapHandlersPipeline = false) where TLogger : Microsoft.Extensions.Http.Logging.IHttpClientLogger;static member AddLogger : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * bool -> Microsoft.Extensions.DependencyInjection.IHttpClientBuilder (requires 'Logger :> Microsoft.Extensions.Http.Logging.IHttpClientLogger)<Extension()>
Public Function AddLogger(Of TLogger As IHttpClientLogger) (builder As IHttpClientBuilder, Optional wrapHandlersPipeline As Boolean = false) As IHttpClientBuilder型パラメーター
- TLogger
DI に登録されたカスタム ロガーのサービスの種類。 ロガーは、 IHttpClientLogger または IHttpClientAsyncLoggerを実装する必要があります。
パラメーター
- builder
- IHttpClientBuilder
- wrapHandlersPipeline
- Boolean
カスタム ロガーを含むログ ハンドラーを追加ハンドラー チェーンの上部または下部に追加するかどうか。
返品
クライアントの構成に使用できる IHttpClientBuilder 。
注釈
wrapHandlersPipelineが 'true' の場合、LogRequestStart(HttpRequestMessage)とLogRequestStartAsync(HttpRequestMessage, CancellationToken)はチェーン内の他のすべてのハンドラーの前に実行されます。
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) と LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) は、他のすべての追加ハンドラーの後に実行され、基本的にパイプライン全体がラップされます。
wrapHandlersPipelineが 'false' の場合、LogRequestStart(HttpRequestMessage)とLogRequestStartAsync(HttpRequestMessage, CancellationToken)は、チェーン内の他のすべての追加ハンドラーの直後、プライマリ ハンドラーの直前に実行されます。
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan)
LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken)は、他のすべての追加ハンドラーの前、プライマリ ハンドラーの直後に実行されます。
TLoggerは、構築中のハンドラー チェーンの有効期間を共有するスコープサービス プロバイダーから解決されます。
AddLogger<TLogger>(IHttpClientBuilder, Boolean)が複数回呼び出されると、複数のロガーが追加されます。 AddLogger<TLogger>(IHttpClientBuilder, Boolean)を呼び出す前にRemoveAllLoggers(IHttpClientBuilder)が呼び出されなかった場合は、既定のロガーに加えて新しいロガーが追加されます。
