HttpClientBuilderExtensions.AddLogger メソッド

定義

名前空間:

Microsoft.Extensions.DependencyInjection

アセンブリ:

Microsoft.Extensions.Http.dll

パッケージ:

Microsoft.Extensions.Http v9.0.0-preview.3.24172.9

オーバーロード

AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean)	という名前 HttpClientの に対して追加のロガーを作成するために使用されるデリゲートを追加します。 カスタム ロガーは、対応する という名前 HttpClientの のすべての要求に対して、専用のログ DelegatingHandler から呼び出されます。
AddLogger<TLogger>(IHttpClientBuilder, Boolean)	という名前 HttpClientの に対して追加のロガーを作成するために使用されるデリゲートを追加します。 カスタム ロガーは、対応する という名前 HttpClientの のすべての要求に対して、専用のログ DelegatingHandler から呼び出されます。

AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean)

ソース:

HttpClientBuilderExtensions.Logging.cs

という名前 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

IHttpClientBuilder。

httpClientLoggerFactory

Func<IServiceProvider,IHttpClientLogger>

カスタム ロガーの作成に使用されるデリゲート。 ロガーは または IHttpClientAsyncLoggerを実装IHttpClientLoggerする必要があります。

wrapHandlersPipeline

Boolean

true カスタム ロガーを含むログ ハンドラーを追加ハンドラー チェーンの先頭に追加する場合は 。 false をクリックして、チェーンの末尾に追加します。

戻り値

IHttpClientBuilder

クライアントを構成するために使用できる 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)

ソース:

HttpClientBuilderExtensions.Logging.cs

という名前 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

IHttpClientBuilder。

wrapHandlersPipeline

Boolean

true カスタム ロガーを含むログ ハンドラーを追加ハンドラー チェーンの先頭に追加する場合は 。 false をクリックして、チェーンの末尾に追加します。

戻り値

IHttpClientBuilder

クライアントを構成するために使用できる 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)は、既定のロガーに加えて新しいロガーが追加されます。