HttpClientBuilderExtensions.AddLogger Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean) |
Aggiunge un delegato che verrà usato per creare un logger aggiuntivo per un oggetto denominato HttpClient. Il logger personalizzato viene richiamato da un delegato di registrazione dedicatoHandler per ogni richiesta del corrispondente denominato HttpClient. |
AddLogger<TLogger>(IHttpClientBuilder, Boolean) |
Aggiunge un delegato che verrà usato per creare un logger aggiuntivo per un oggetto denominato HttpClient. Il logger personalizzato viene richiamato da un delegato di registrazione dedicatoHandler per ogni richiesta del corrispondente denominato HttpClient. |
AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean)
Aggiunge un delegato che verrà usato per creare un logger aggiuntivo per un oggetto denominato HttpClient. Il logger personalizzato viene richiamato da un delegato di registrazione dedicatoHandler per ogni richiesta del corrispondente denominato 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
Parametri
- builder
- IHttpClientBuilder
Oggetto IHttpClientBuilder.
- httpClientLoggerFactory
- Func<IServiceProvider,IHttpClientLogger>
Delegato usato per creare un logger personalizzato. Il logger deve implementare IHttpClientLogger o IHttpClientAsyncLogger.
- wrapHandlersPipeline
- Boolean
true
per aggiungere il gestore di registrazione con il logger personalizzato all'inizio della catena di gestori aggiuntivi; false
per aggiungerlo alla fine della catena.
Restituisce
Oggetto IHttpClientBuilder che è possibile usare per configurare il client.
Commenti
Se wrapHandlersPipeline
è "true" LogRequestStart(HttpRequestMessage) e LogRequestStartAsync(HttpRequestMessage, CancellationToken) verrà eseguito prima di tutti gli altri gestori aggiuntivi nella catena.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) e LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) verranno eseguiti dopo tutti gli altri gestori aggiuntivi, essenzialmente il wrapping dell'intera pipeline.
Se wrapHandlersPipeline
è "false" LogRequestStart(HttpRequestMessage) e LogRequestStartAsync(HttpRequestMessage, CancellationToken) verrà eseguito dopo tutti gli altri gestori aggiuntivi nella catena, subito prima del gestore primario.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) e LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) verranno eseguiti prima di tutti gli altri gestori aggiuntivi, subito dopo il gestore primario.
L'argomento IServiceProvider fornito a httpClientLoggerFactory
sarà un riferimento a un provider di servizi con ambito che condivide la durata della catena del gestore da costruire.
Se AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean) viene chiamato più volte, verranno aggiunti più logger. Se RemoveAllLoggers(IHttpClientBuilder) non è stato chiamato prima di chiamare AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean), verrà aggiunto un nuovo logger oltre a quelli predefiniti.
Si applica a
AddLogger<TLogger>(IHttpClientBuilder, Boolean)
Aggiunge un delegato che verrà usato per creare un logger aggiuntivo per un oggetto denominato HttpClient. Il logger personalizzato viene richiamato da un delegato di registrazione dedicatoHandler per ogni richiesta del corrispondente denominato 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
Parametri di tipo
- TLogger
Tipo di servizio del logger personalizzato registrato nell'inserimento delle dipendenze. Il logger deve implementare IHttpClientLogger o IHttpClientAsyncLogger.
Parametri
- builder
- IHttpClientBuilder
Oggetto IHttpClientBuilder.
- wrapHandlersPipeline
- Boolean
true
per aggiungere il gestore di registrazione con il logger personalizzato all'inizio della catena di gestori aggiuntivi; false
per aggiungerlo alla fine della catena.
Restituisce
Oggetto IHttpClientBuilder che è possibile usare per configurare il client.
Commenti
Se wrapHandlersPipeline
è "true" LogRequestStart(HttpRequestMessage) e LogRequestStartAsync(HttpRequestMessage, CancellationToken) verrà eseguito prima di tutti gli altri gestori aggiuntivi nella catena.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) e LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) verranno eseguiti dopo tutti gli altri gestori aggiuntivi, essenzialmente il wrapping dell'intera pipeline.
Se wrapHandlersPipeline
è "false" LogRequestStart(HttpRequestMessage) e LogRequestStartAsync(HttpRequestMessage, CancellationToken) verrà eseguito dopo tutti gli altri gestori aggiuntivi nella catena, subito prima del gestore primario.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) e LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) verranno eseguiti prima di tutti gli altri gestori aggiuntivi, subito dopo il gestore primario.
Verrà TLogger
risolto da un provider di servizi con ambito che condivide la durata della catena del gestore in fase di costruzione.
Se AddLogger<TLogger>(IHttpClientBuilder, Boolean) viene chiamato più volte, verranno aggiunti più logger. Se RemoveAllLoggers(IHttpClientBuilder) non è stato chiamato prima di chiamare AddLogger<TLogger>(IHttpClientBuilder, Boolean), verrà aggiunto un nuovo logger oltre a quelli predefiniti.