IHttpClientAsyncLogger Interfejs

Definicja

Przestrzeń nazw:

Microsoft.Extensions.Http.Logging

Zestaw:

Microsoft.Extensions.Http.dll

Pakiet:

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

Źródło:

IHttpClientAsyncLogger.cs

Abstrakcja dla asynchronicznego rejestrowania niestandardowych żądań HTTP dla nazwanych HttpClient wystąpień zwróconych przez 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

Implementuje

IHttpClientLogger

Uwagi

Metody asynchroniczne (takie jak LogRequestStartAsync(HttpRequestMessage, CancellationToken)) są wywoływane ze ścieżek kodu asynchronicznego (takich jak SendAsync(HttpRequestMessage, CancellationToken)). Ich synchroniczne odpowiedniki dziedziczone z IHttpClientLogger (na przykład LogRequestStart(HttpRequestMessage)) są wywoływane z odpowiednich ścieżek kodu synchronizacji.

Użytkownik implementuje interfejs, aby zdecydować, gdzie (do ILogger, lub cokolwiek innego) i co dokładnie należy zarejestrować. Jednak implementacja powinna być świadoma potencjalnych negatywnych skutków ubocznych uzyskiwania dostępu do niektórych HttpRequestMessage właściwości lub HttpResponseMessage , takich jak odczytywanie ze strumienia zawartości. Jeśli to możliwe, należy unikać takiego zachowania.

Implementacja rejestrowania nie powinna zgłaszać żadnych wyjątków, ponieważ nieobsługiwany wyjątek w rejestrowaniu zakończy się niepowodzeniem żądania.

Metody

LogRequestFailed(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan)	Rejestruje wyjątek, który wystąpił podczas wysyłania żądania HTTP. (Odziedziczone po IHttpClientLogger)
LogRequestFailedAsync(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan, CancellationToken)	Rejestruje wyjątek, który wystąpił podczas wysyłania żądania HTTP.
LogRequestStart(HttpRequestMessage)	Dzienniki przed wysłaniem żądania HTTP. (Odziedziczone po IHttpClientLogger)
LogRequestStartAsync(HttpRequestMessage, CancellationToken)	Dzienniki przed wysłaniem żądania HTTP.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan)	Dzienniki po otrzymaniu odpowiedzi HTTP. (Odziedziczone po IHttpClientLogger)
LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken)	Dzienniki po otrzymaniu odpowiedzi HTTP.