Udostępnij za pośrednictwem


IHttpClientAsyncLogger Interfejs

Definicja

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

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.

Dotyczy