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>
カスタム ロガーの作成に使用されるデリゲート。 ロガーは または IHttpClientAsyncLoggerを実装IHttpClientLoggerする必要があります。
- wrapHandlersPipeline
- Boolean
true カスタム ロガーを含むログ ハンドラーを追加ハンドラー チェーンの先頭に追加する場合は 。 false をクリックして、チェーンの末尾に追加します。
戻り値
クライアントを構成するために使用できる IHttpClientBuilder。
注釈
が 'true' の場合wrapHandlersPipeline、LogRequestStartAsync(HttpRequestMessage, CancellationToken)LogRequestStart(HttpRequestMessage)チェーン内の他のすべての追加ハンドラーの前に が実行されます。
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) と LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) は、基本的にパイプライン全体をラップする他のすべての追加ハンドラーの後に実行されます。
が 'false' の場合wrapHandlersPipeline、LogRequestStartAsync(HttpRequestMessage, CancellationToken)LogRequestStart(HttpRequestMessage)チェーン内の他のすべての追加ハンドラーの直後、プライマリ ハンドラーの直前に実行されます。
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 に登録されたカスタム ロガーのサービスの種類。 ロガーは または IHttpClientAsyncLoggerを実装IHttpClientLoggerする必要があります。
パラメーター
- builder
- IHttpClientBuilder
- wrapHandlersPipeline
- Boolean
true カスタム ロガーを含むログ ハンドラーを追加ハンドラー チェーンの先頭に追加する場合は 。 false をクリックして、チェーンの末尾に追加します。
戻り値
クライアントを構成するために使用できる IHttpClientBuilder。
注釈
が 'true' の場合wrapHandlersPipeline、LogRequestStartAsync(HttpRequestMessage, CancellationToken)LogRequestStart(HttpRequestMessage)チェーン内の他のすべての追加ハンドラーの前に が実行されます。
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) と LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) は、基本的にパイプライン全体をラップする他のすべての追加ハンドラーの後に実行されます。
が 'false' の場合wrapHandlersPipeline、LogRequestStartAsync(HttpRequestMessage, CancellationToken)LogRequestStart(HttpRequestMessage)チェーン内の他のすべての追加ハンドラーの直後、プライマリ ハンドラーの直前に実行されます。
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) と LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) は、他のすべての追加ハンドラーの前、プライマリ ハンドラーの直後に実行されます。
は TLogger 、構築されるハンドラー チェーンの有効期間を共有するスコープ付きサービス プロバイダーから解決されます。
が複数回呼び出される場合 AddLogger<TLogger>(IHttpClientBuilder, Boolean) は、複数のロガーが追加されます。 を呼び出す前に が呼び出AddLogger<TLogger>(IHttpClientBuilder, Boolean)されなかった場合RemoveAllLoggers(IHttpClientBuilder)は、既定のロガーに加えて新しいロガーが追加されます。
適用対象
.NET