IHttpClientAsyncLogger Interface

Definição

Namespace:

Microsoft.Extensions.Http.Logging

Assembly:

Microsoft.Extensions.Http.dll

Pacote:

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

Origem:

IHttpClientAsyncLogger.cs

Uma abstração para registro em log de solicitação HTTP personalizada assíncrona para instâncias nomeadas retornadas HttpClient 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)) são chamados de caminhos de código assíncronos (como SendAsync(HttpRequestMessage, CancellationToken)). Seus equivalentes síncronos herdados de IHttpClientLogger (como LogRequestStart(HttpRequestMessage)) são 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 registrar. No entanto, a implementação deve estar atenta a possíveis efeitos colaterais adversos do acesso a algumas das HttpRequestMessage propriedades ou HttpResponseMessage , como a leitura de um fluxo de conteúdo. Se possível, esse comportamento deve ser evitado.

A implementação de log 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 a exceção que ocorreu ao enviar uma solicitação HTTP. (Herdado de IHttpClientLogger)
LogRequestFailedAsync(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan, CancellationToken)	Registra a exceção que 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.