IHttpClientAsyncLogger Interface

Définition

Espace de noms:

Microsoft.Extensions.Http.Logging

Assembly:

Microsoft.Extensions.Http.dll

Paquet:

Microsoft.Extensions.Http v9.0.0-preview.3.24172.9

Source:

IHttpClientAsyncLogger.cs

Abstraction pour la journalisation des requêtes HTTP personnalisées asynchrones pour les instances nommées HttpClient retournées par IHttpClientFactory.

public interface class IHttpClientAsyncLogger : Microsoft::Extensions::Http::Logging::IHttpClientLogger

public interface IHttpClientAsyncLogger : Microsoft.Extensions.Http.Logging.IHttpClientLogger

type IHttpClientAsyncLogger = interface
    interface IHttpClientLogger

Public Interface IHttpClientAsyncLogger
Implements IHttpClientLogger

Implémente

IHttpClientLogger

Remarques

Les méthodes asynchrones (telles que LogRequestStartAsync(HttpRequestMessage, CancellationToken)) sont appelées à partir de chemins de code asynchrones (tels que SendAsync(HttpRequestMessage, CancellationToken)). Leurs équivalents synchrones hérités de IHttpClientLogger (tels que LogRequestStart(HttpRequestMessage)) sont appelés à partir des chemins de code de synchronisation correspondants.

C’est à l’utilisateur qui implémente l’interface de décider où (pour ILogger, ou quoi que ce soit d’autre) et ce qu’il doit enregistrer exactement. Toutefois, l’implémentation doit être attentive aux effets secondaires potentiels de l’accès à certaines propriétés ouHttpResponseMessage, comme la HttpRequestMessage lecture à partir d’un flux de contenu. Si possible, ce comportement doit être évité.

L’implémentation de la journalisation ne doit pas lever d’exceptions, car une exception non gérée dans la journalisation échouerait à la demande.

Méthodes

LogRequestFailed(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan)	Enregistre l’exception qui s’est produite lors de l’envoi d’une requête HTTP. (Hérité de IHttpClientLogger)
LogRequestFailedAsync(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan, CancellationToken)	Enregistre l’exception qui s’est produite lors de l’envoi d’une requête HTTP.
LogRequestStart(HttpRequestMessage)	Journaux avant d’envoyer une requête HTTP. (Hérité de IHttpClientLogger)
LogRequestStartAsync(HttpRequestMessage, CancellationToken)	Journaux avant d’envoyer une requête HTTP.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan)	Journaux après réception d’une réponse HTTP. (Hérité de IHttpClientLogger)
LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken)	Journaux après réception d’une réponse HTTP.