IHttpClientAsyncLogger Interface
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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::IHttpClientLoggerpublic interface IHttpClientAsyncLogger : Microsoft.Extensions.Http.Logging.IHttpClientLoggertype IHttpClientAsyncLogger = interface
interface IHttpClientLoggerPublic Interface IHttpClientAsyncLogger
Implements IHttpClientLogger- Implementações
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. |
