IHttpClientAsyncLogger Interfaz

Definición

Espacio de nombres:

Microsoft.Extensions.Http.Logging

Ensamblado:

Microsoft.Extensions.Http.dll

Paquete:

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

Source:

IHttpClientAsyncLogger.cs

Abstracción para el registro de solicitudes HTTP personalizadas asincrónicas para instancias con nombre HttpClient devueltas por 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

Implementaciones

IHttpClientLogger

Comentarios

Los métodos asincrónicos (como LogRequestStartAsync(HttpRequestMessage, CancellationToken)) se llaman desde rutas de acceso de código asincrónicas (como SendAsync(HttpRequestMessage, CancellationToken)). Se llama a sus homólogos sincrónicos heredados de IHttpClientLogger (como LogRequestStart(HttpRequestMessage)) desde las rutas de acceso de código de sincronización correspondientes.

Es el usuario que implementa la interfaz para decidir dónde (para ILogger, o cualquier otra cosa) y qué exactamente se debe registrar. Sin embargo, la implementación debe tener en cuenta los posibles efectos secundarios adversos del acceso a algunas de las propiedades o HttpResponseMessage , como la HttpRequestMessage lectura de una secuencia de contenido. Si es posible, se debe evitar este comportamiento.

La implementación de registro no debe producir ninguna excepción, ya que una excepción no controlada en el registro produciría un error en la solicitud.

Métodos

LogRequestFailed(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan)	Registra la excepción que se produjo al enviar una solicitud HTTP. (Heredado de IHttpClientLogger)
LogRequestFailedAsync(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan, CancellationToken)	Registra la excepción que se produjo al enviar una solicitud HTTP.
LogRequestStart(HttpRequestMessage)	Registra antes de enviar una solicitud HTTP. (Heredado de IHttpClientLogger)
LogRequestStartAsync(HttpRequestMessage, CancellationToken)	Registra antes de enviar una solicitud HTTP.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan)	Registra después de recibir una respuesta HTTP. (Heredado de IHttpClientLogger)
LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken)	Registra después de recibir una respuesta HTTP.