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. Пользовательское средство ведения журнала будет вызываться из выделенного ведения журнала DelegatingHandler при каждом запросе соответствующего объекта с именем HttpClient.
AddLogger<TLogger>(IHttpClientBuilder, Boolean)	Добавляет делегат, который будет использоваться для создания дополнительного средства ведения журнала для с именем HttpClient. Пользовательское средство ведения журнала будет вызываться из выделенного ведения журнала DelegatingHandler при каждом запросе соответствующего объекта с именем HttpClient.

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

Исходный код:

HttpClientBuilderExtensions.Logging.cs

Добавляет делегат, который будет использоваться для создания дополнительного средства ведения журнала для с именем HttpClient. Пользовательское средство ведения журнала будет вызываться из выделенного ведения журнала DelegatingHandler при каждом запросе соответствующего объекта с именем HttpClient.

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>

Делегат, используемый для создания пользовательского средства ведения журнала. Средство ведения журнала должно реализовывать IHttpClientLogger или IHttpClientAsyncLogger.

wrapHandlersPipeline

Boolean

true , чтобы добавить обработчик ведения журнала с пользовательским средство ведения журнала в начало цепочки дополнительных обработчиков; false , чтобы добавить его в конец цепочки.

Возвращаемое значение

IHttpClientBuilder

Интерфейс 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) будут выполняться перед всеми другими дополнительными обработчиками сразу после основного обработчика.

Аргумент IServiceProvider , предоставленный для , httpClientLoggerFactory будет ссылкой на поставщика услуг с заданной областью, который использует время существования создаваемой цепочки обработчиков.

Если AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean) вызывается несколько раз, будет добавлено несколько средств ведения журнала. Если RemoveAllLoggers(IHttpClientBuilder) не был вызван перед вызовом AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean), в дополнение к стандартным будет добавлено новое средство ведения журнала.

AddLogger<TLogger>(IHttpClientBuilder, Boolean)

Исходный код:

HttpClientBuilderExtensions.Logging.cs

Добавляет делегат, который будет использоваться для создания дополнительного средства ведения журнала для с именем HttpClient. Пользовательское средство ведения журнала будет вызываться из выделенного ведения журнала DelegatingHandler при каждом запросе соответствующего объекта с именем HttpClient.

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 di. Средство ведения журнала должно реализовывать IHttpClientLogger или IHttpClientAsyncLogger.

Параметры

builder

IHttpClientBuilder

IHttpClientBuilder.

wrapHandlersPipeline

Boolean

true , чтобы добавить обработчик ведения журнала с пользовательским средство ведения журнала в начало цепочки дополнительных обработчиков; false , чтобы добавить его в конец цепочки.

Возвращаемое значение

IHttpClientBuilder

Интерфейс 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) вызывается несколько раз, будет добавлено несколько средств ведения журнала. Если RemoveAllLoggers(IHttpClientBuilder) не был вызван перед вызовом AddLogger<TLogger>(IHttpClientBuilder, Boolean), в дополнение к стандартным будет добавлено новое средство ведения журнала.