HttpClientBuilderExtensions.AddLogger Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean) |
Ajoute un délégué qui sera utilisé pour créer un journal supplémentaire pour un nommé HttpClient. L’enregistreur d’événements personnalisé est appelé à partir d’un gestionnaire de délégation de journalisation dédié à chaque requête du nommé HttpClientcorrespondant. |
| AddLogger<TLogger>(IHttpClientBuilder, Boolean) |
Ajoute un délégué qui sera utilisé pour créer un journal supplémentaire pour un nommé HttpClient. L’enregistreur d’événements personnalisé est appelé à partir d’un gestionnaire de délégation de journalisation dédié à chaque requête du nommé HttpClientcorrespondant. |
AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean)
Ajoute un délégué qui sera utilisé pour créer un journal supplémentaire pour un nommé HttpClient. L’enregistreur d’événements personnalisé est appelé à partir d’un gestionnaire de délégation de journalisation dédié à chaque requête du nommé HttpClientcorrespondant.
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 IHttpClientBuilderParamètres
- builder
- IHttpClientBuilder
- httpClientLoggerFactory
- Func<IServiceProvider,IHttpClientLogger>
Délégué utilisé pour créer un enregistreur d’événements personnalisé. L’enregistreur d’événements doit implémenter IHttpClientLogger ou IHttpClientAsyncLogger.
- wrapHandlersPipeline
- Boolean
true pour ajouter le gestionnaire de journalisation avec l’enregistreur d’événements personnalisé au début de la chaîne de gestionnaires supplémentaires ; false pour l’ajouter à la fin de la chaîne.
Retours
IHttpClientBuilder qui peut être utilisé pour configurer le client.
Remarques
Si wrapHandlersPipeline a la valeur « true » LogRequestStart(HttpRequestMessage) et LogRequestStartAsync(HttpRequestMessage, CancellationToken) est exécuté avant tous les autres gestionnaires supplémentaires dans la chaîne.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) et LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) seraient exécutés après tous les autres gestionnaires supplémentaires, en encapsulant essentiellement l’ensemble du pipeline.
Si wrapHandlersPipeline a la valeur « false » LogRequestStart(HttpRequestMessage) et LogRequestStartAsync(HttpRequestMessage, CancellationToken) est exécuté après tous les autres gestionnaires supplémentaires dans la chaîne, juste avant le gestionnaire principal.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) et LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) sont exécutés avant tous les autres gestionnaires supplémentaires, juste après le gestionnaire principal.
L’argument IServiceProvider fourni à httpClientLoggerFactory est une référence à un fournisseur de services étendu qui partage la durée de vie de la chaîne de gestionnaire en cours de construction.
Si AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean) est appelé plusieurs fois, plusieurs enregistreurs d’événements sont ajoutés. Si RemoveAllLoggers(IHttpClientBuilder) n’a pas été appelé avant d’appeler AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean), un nouvel enregistreur d’événements est ajouté en plus des événements par défaut.
S’applique à
AddLogger<TLogger>(IHttpClientBuilder, Boolean)
Ajoute un délégué qui sera utilisé pour créer un journal supplémentaire pour un nommé HttpClient. L’enregistreur d’événements personnalisé est appelé à partir d’un gestionnaire de délégation de journalisation dédié à chaque requête du nommé HttpClientcorrespondant.
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 IHttpClientBuilderParamètres de type
- TLogger
Type de service de l’enregistreur d’événements personnalisé tel qu’il a été inscrit dans DI. L’enregistreur d’événements doit implémenter IHttpClientLogger ou IHttpClientAsyncLogger.
Paramètres
- builder
- IHttpClientBuilder
- wrapHandlersPipeline
- Boolean
true pour ajouter le gestionnaire de journalisation avec l’enregistreur d’événements personnalisé au début de la chaîne de gestionnaires supplémentaires ; false pour l’ajouter à la fin de la chaîne.
Retours
IHttpClientBuilder qui peut être utilisé pour configurer le client.
Remarques
Si wrapHandlersPipeline a la valeur « true » LogRequestStart(HttpRequestMessage) et LogRequestStartAsync(HttpRequestMessage, CancellationToken) est exécuté avant tous les autres gestionnaires supplémentaires dans la chaîne.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) et LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) seraient exécutés après tous les autres gestionnaires supplémentaires, en encapsulant essentiellement l’ensemble du pipeline.
Si wrapHandlersPipeline a la valeur « false » LogRequestStart(HttpRequestMessage) et LogRequestStartAsync(HttpRequestMessage, CancellationToken) est exécuté après tous les autres gestionnaires supplémentaires dans la chaîne, juste avant le gestionnaire principal.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) et LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) sont exécutés avant tous les autres gestionnaires supplémentaires, juste après le gestionnaire principal.
Le TLogger sera résolu à partir d’un fournisseur de services étendu qui partage la durée de vie de la chaîne de gestionnaire en cours de construction.
Si AddLogger<TLogger>(IHttpClientBuilder, Boolean) est appelé plusieurs fois, plusieurs enregistreurs d’événements sont ajoutés. Si RemoveAllLoggers(IHttpClientBuilder) n’a pas été appelé avant d’appeler AddLogger<TLogger>(IHttpClientBuilder, Boolean), un nouvel enregistreur d’événements est ajouté en plus des événements par défaut.
