HttpClientBuilderExtensions.AddLogger Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Имя | Описание |
|---|---|
| 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
- Исходный код:
- HttpClientBuilderExtensions.Logging.cs
- Исходный код:
- HttpClientBuilderExtensions.Logging.cs
- Исходный код:
- 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
Будет ли обработчик ведения журнала с пользовательским средством ведения журнала добавляться в верхнюю или в нижней части дополнительных цепочек обработчиков.
Возвращаемое значение
Можно 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
- Исходный код:
- HttpClientBuilderExtensions.Logging.cs
- Исходный код:
- HttpClientBuilderExtensions.Logging.cs
- Исходный код:
- 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. Средство ведения журнала должно реализовать IHttpClientLogger или IHttpClientAsyncLogger.
Параметры
- builder
- IHttpClientBuilder
Объект 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) вызывается несколько раз, будет добавлено несколько средств ведения журнала. Если RemoveAllLoggers(IHttpClientBuilder) не было вызвано перед вызовом AddLogger<TLogger>(IHttpClientBuilder, Boolean), то новый средство ведения журнала будет добавлено в дополнение к стандартным.