IHttpClientAsyncLogger Интерфейс

Определение

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

Microsoft.Extensions.Http.Logging

Сборка:

Microsoft.Extensions.Http.dll

Пакет:

Microsoft.Extensions.Http v11.0.0-preview.5.26302.115

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

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