HttpClientBuilderExtensions.AddLogger Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean) |
Agrega un delegado que se usará para crear un registrador adicional para un objeto denominado HttpClient. El registrador personalizado se invocaría desde un registro dedicado DelegatingHandler en cada solicitud del correspondiente denominado HttpClient. |
| AddLogger<TLogger>(IHttpClientBuilder, Boolean) |
Agrega un delegado que se usará para crear un registrador adicional para un objeto denominado HttpClient. El registrador personalizado se invocaría desde un registro dedicado DelegatingHandler en cada solicitud del correspondiente denominado HttpClient. |
AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean)
Agrega un delegado que se usará para crear un registrador adicional para un objeto denominado HttpClient. El registrador personalizado se invocaría desde un registro dedicado DelegatingHandler en cada solicitud del correspondiente denominado 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 IHttpClientBuilderParámetros
- builder
- IHttpClientBuilder
El parámetro de cadena de consulta IHttpClientBuilder.
- httpClientLoggerFactory
- Func<IServiceProvider,IHttpClientLogger>
Delegado que se usa para crear un registrador personalizado. El registrador debe implementar IHttpClientLogger o IHttpClientAsyncLogger.
- wrapHandlersPipeline
- Boolean
true para agregar el controlador de registro con el registrador personalizado al principio de la cadena de controladores adicionales; false para agregarlo al final de la cadena.
Devoluciones
Un objeto IHttpClientBuilder que se puede usar para configurar el cliente.
Comentarios
Si wrapHandlersPipeline es "true", LogRequestStart(HttpRequestMessage) y LogRequestStartAsync(HttpRequestMessage, CancellationToken) se ejecutaría antes de todos los demás controladores adicionales de la cadena. LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) y LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) se ejecutarían después de todos los demás controladores adicionales, encapsulando básicamente toda la canalización.
Si wrapHandlersPipeline es "false" LogRequestStart(HttpRequestMessage) y LogRequestStartAsync(HttpRequestMessage, CancellationToken) se ejecutaría después de todos los demás controladores adicionales de la cadena, justo antes del controlador principal. LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) y LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) se ejecutarían antes de todos los demás controladores adicionales, justo después del controlador principal.
El IServiceProvider argumento proporcionado para httpClientLoggerFactory será una referencia a un proveedor de servicios con ámbito que comparte la duración de la cadena de controladores que se está construyendo.
Si AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean) se llama varias veces, se agregarían varios registradores. Si RemoveAllLoggers(IHttpClientBuilder) no se llamó a antes de llamar a AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean), se agregaría un nuevo registrador además de los predeterminados.
Se aplica a
AddLogger<TLogger>(IHttpClientBuilder, Boolean)
Agrega un delegado que se usará para crear un registrador adicional para un objeto denominado HttpClient. El registrador personalizado se invocaría desde un registro dedicado DelegatingHandler en cada solicitud del correspondiente denominado 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 IHttpClientBuilderParámetros de tipo
- TLogger
Tipo de servicio del registrador personalizado tal como se registró en la inserción de dependencias. El registrador debe implementar IHttpClientLogger o IHttpClientAsyncLogger.
Parámetros
- builder
- IHttpClientBuilder
El parámetro de cadena de consulta IHttpClientBuilder.
- wrapHandlersPipeline
- Boolean
true para agregar el controlador de registro con el registrador personalizado al principio de la cadena de controladores adicionales; false para agregarlo al final de la cadena.
Devoluciones
Un objeto IHttpClientBuilder que se puede usar para configurar el cliente.
Comentarios
Si wrapHandlersPipeline es "true", LogRequestStart(HttpRequestMessage) y LogRequestStartAsync(HttpRequestMessage, CancellationToken) se ejecutaría antes de todos los demás controladores adicionales de la cadena. LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) y LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) se ejecutarían después de todos los demás controladores adicionales, encapsulando básicamente toda la canalización.
Si wrapHandlersPipeline es "false" LogRequestStart(HttpRequestMessage) y LogRequestStartAsync(HttpRequestMessage, CancellationToken) se ejecutaría después de todos los demás controladores adicionales de la cadena, justo antes del controlador principal. LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) y LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) se ejecutarían antes de todos los demás controladores adicionales, justo después del controlador principal.
TLogger Se resolverá a partir de un proveedor de servicios con ámbito que comparte la duración de la cadena de controladores que se está construyendo.
Si AddLogger<TLogger>(IHttpClientBuilder, Boolean) se llama varias veces, se agregarían varios registradores. Si RemoveAllLoggers(IHttpClientBuilder) no se llamó a antes de llamar a AddLogger<TLogger>(IHttpClientBuilder, Boolean), se agregaría un nuevo registrador además de los predeterminados.
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de