HttpClientBuilderExtensions.AddLogger Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean) |
Adiciona um delegado que será usado para criar um logger adicional para um .HttpClient O logger personalizado seria invocado a partir de um DelegatingHandler dedicado para registos em cada pedido do correspondente nome HttpClient. |
| AddLogger<TLogger>(IHttpClientBuilder, Boolean) |
Adiciona um delegado que será usado para criar um logger adicional para um .HttpClient O logger personalizado seria invocado a partir de um DelegatingHandler dedicado para registos em cada pedido do correspondente nome HttpClient. |
AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean)
Adiciona um delegado que será usado para criar um logger adicional para um .HttpClient O logger personalizado seria invocado a partir de um DelegatingHandler dedicado para registos em cada pedido do correspondente nome 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
Parâmetros
- builder
- IHttpClientBuilder
- httpClientLoggerFactory
- Func<IServiceProvider,IHttpClientLogger>
Um delegado que é usado para criar um logger personalizado. O logger deve implementar IHttpClientLogger ou IHttpClientAsyncLogger.
- wrapHandlersPipeline
- Boolean
Se o handler de registo com o logger personalizado seria adicionado ao topo ou ao fundo das cadeias adicionais do handler.
Devoluções
Um IHttpClientBuilder que pode ser usado para configurar o cliente.
Observações
Se o wrapHandlersPipeline for 'verdadeiro', LogRequestStart(HttpRequestMessage) e LogRequestStartAsync(HttpRequestMessage, CancellationToken) seria executado antes de todos os outros manipuladores adicionais na cadeia.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) e LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) seria executado depois de todos os outros handlers adicionais, essencialmente envolvendo todo o pipeline.
Se for wrapHandlersPipeline 'falso', LogRequestStart(HttpRequestMessage) e LogRequestStartAsync(HttpRequestMessage, CancellationToken) seria executado depois de todos os outros manipuladores adicionais na cadeia, logo antes do manipulador principal.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) e LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) seria executado antes de todos os outros manipuladores adicionais, logo a seguir ao handler principal.
O IServiceProvider argumento apresentado httpClientLoggerFactory será uma referência a um fornecedor de serviços com âmbito que partilha a vida útil da cadeia de handlers que está a ser construída.
Se AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean) for chamado várias vezes, serão adicionados vários loggers. Se RemoveAllLoggers(IHttpClientBuilder) não foi chamado antes da chamada AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean), então um novo logger seria adicionado além dos predefinidos.
Aplica-se a
AddLogger<TLogger>(IHttpClientBuilder, Boolean)
Adiciona um delegado que será usado para criar um logger adicional para um .HttpClient O logger personalizado seria invocado a partir de um DelegatingHandler dedicado para registos em cada pedido do correspondente nome 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
Parâmetros de Tipo Genérico
- TLogger
O tipo de serviço do logger personalizado tal como estava registado em DI. O logger deve implementar IHttpClientLogger ou IHttpClientAsyncLogger.
Parâmetros
- builder
- IHttpClientBuilder
- wrapHandlersPipeline
- Boolean
Se o handler de registo com o logger personalizado seria adicionado ao topo ou ao fundo das cadeias adicionais do handler.
Devoluções
Um IHttpClientBuilder que pode ser usado para configurar o cliente.
Observações
Se o wrapHandlersPipeline for 'verdadeiro', LogRequestStart(HttpRequestMessage) e LogRequestStartAsync(HttpRequestMessage, CancellationToken) seria executado antes de todos os outros manipuladores adicionais na cadeia.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) e LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) seria executado depois de todos os outros handlers adicionais, essencialmente envolvendo todo o pipeline.
Se for wrapHandlersPipeline 'falso', LogRequestStart(HttpRequestMessage) e LogRequestStartAsync(HttpRequestMessage, CancellationToken) seria executado depois de todos os outros manipuladores adicionais na cadeia, logo antes do manipulador principal.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) e LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) seria executado antes de todos os outros manipuladores adicionais, logo a seguir ao handler principal.
O TLogger problema será resolvido por um fornecedor de serviços com âmbito que partilha a vida útil da cadeia de manipuladores em construção.
Se AddLogger<TLogger>(IHttpClientBuilder, Boolean) for chamado várias vezes, serão adicionados vários loggers. Se RemoveAllLoggers(IHttpClientBuilder) não foi chamado antes da chamada AddLogger<TLogger>(IHttpClientBuilder, Boolean), então um novo logger seria adicionado além dos predefinidos.