Поделиться через


IHttpClientAsyncLogger Интерфейс

Определение

Абстракция для асинхронного пользовательского ведения журнала HTTP-запросов для именованных HttpClient экземпляров, возвращаемых .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
Реализации

Комментарии

Асинхронные методы (например, LogRequestStartAsync(HttpRequestMessage, CancellationToken)) вызываются из путей асинхронного кода (например, SendAsync(HttpRequestMessage, CancellationToken)). Их синхронные аналоги, унаследованные от IHttpClientLogger (например, LogRequestStart(HttpRequestMessage)), вызываются из соответствующих путей кода синхронизации.

Пользователь, реализуя интерфейс, должен решить, где (или ILoggerчто-либо еще) и что именно регистрировать. Однако реализация должна учитывать потенциальные побочные эффекты доступа к некоторым HttpRequestMessage свойствам или HttpResponseMessage , например чтение из потока содержимого. По возможности такого поведения следует избегать.

Реализация ведения журнала не должна вызывать никаких исключений, так как необработанное исключение в журнале приведет к сбою запроса.

Методы

LogRequestFailed(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan)

Регистрирует исключение, которое произошло при отправке HTTP-запроса.

(Унаследовано от IHttpClientLogger)
LogRequestFailedAsync(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan, CancellationToken)

Регистрирует исключение, которое произошло при отправке HTTP-запроса.

LogRequestStart(HttpRequestMessage)

Регистрирует перед отправкой HTTP-запроса.

(Унаследовано от IHttpClientLogger)
LogRequestStartAsync(HttpRequestMessage, CancellationToken)

Регистрирует перед отправкой HTTP-запроса.

LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan)

Регистрируется после получения HTTP-ответа.

(Унаследовано от IHttpClientLogger)
LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken)

Регистрируется после получения HTTP-ответа.

Применяется к