IHttpClientAsyncLogger Interface

Definição

Namespace:

Microsoft.Extensions.Http.Logging

Assembly:

Microsoft.Extensions.Http.dll

Pacote:

Microsoft.Extensions.Http v9.0.0

Origem:

IHttpClientAsyncLogger.cs

Uma abstração para registro em log de solicitação HTTP personalizada assíncrona para instâncias de HttpClient nomeadas retornadas 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

Implementações

IHttpClientLogger

Comentários

Métodos assíncronos (como LogRequestStartAsync(HttpRequestMessage, CancellationToken)) seriam chamados de caminhos de código assíncronos (como SendAsync(HttpRequestMessage, CancellationToken)) e seus equivalentes síncronos herdados de IHttpClientLogger (como LogRequestStart(HttpRequestMessage)) seriam chamados dos caminhos de código de sincronização correspondentes.

Cabe ao usuário implementar a interface para decidir onde (para ILoggerou qualquer outra coisa) e o que exatamente fazer logon. No entanto, a implementação deve estar atenta a possíveis efeitos colaterais adversos de acessar algumas das propriedades HttpRequestMessage ou HttpResponseMessage, como a leitura de um fluxo de conteúdo; se possível, esse comportamento deve ser evitado.

A implementação do registro em log também não deve gerar exceções, pois uma exceção sem tratamento no registro em log falharia na solicitação.

Métodos

LogRequestFailed(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan)	Registra os logs em que a exceção ocorreu ao enviar uma solicitação HTTP. (Herdado de IHttpClientLogger)
LogRequestFailedAsync(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan, CancellationToken)	Registra os logs em que a exceção ocorreu ao enviar uma solicitação HTTP.
LogRequestStart(HttpRequestMessage)	Registra antes de enviar uma solicitação HTTP. (Herdado de IHttpClientLogger)
LogRequestStartAsync(HttpRequestMessage, CancellationToken)	Registra antes de enviar uma solicitação HTTP.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan)	Registra após receber uma resposta HTTP. (Herdado de IHttpClientLogger)
LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken)	Registra após receber uma resposta HTTP.