IHttpClientAsyncLogger Интерфейс

Определение

Пространство имен:

Microsoft.Extensions.Http.Logging

Сборка:

Microsoft.Extensions.Http.dll

Пакет:

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

Исходный код:

IHttpClientAsyncLogger.cs

Абстракция для асинхронного пользовательского ведения журнала 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

Реализации

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-ответа.