IHttpClientAsyncLogger Rozhraní
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Abstrakce pro asynchronní vlastní protokolování požadavků HTTP pro pojmenované HttpClient instance vrácené nástrojem IHttpClientFactory.
public interface class IHttpClientAsyncLogger : Microsoft::Extensions::Http::Logging::IHttpClientLoggerpublic interface IHttpClientAsyncLogger : Microsoft.Extensions.Http.Logging.IHttpClientLoggertype IHttpClientAsyncLogger = interface
interface IHttpClientLoggerPublic Interface IHttpClientAsyncLogger
Implements IHttpClientLogger- Implementuje
Poznámky
Asynchronní metody (například LogRequestStartAsync(HttpRequestMessage, CancellationToken)) se volají z cest asynchronního kódu (například SendAsync(HttpRequestMessage, CancellationToken)). Jejich synchronní protějšky zděděné z IHttpClientLogger (například LogRequestStart(HttpRequestMessage)) se volají z odpovídajících cest synchronizačního kódu.
Je na uživateli, který implementuje rozhraní, aby se rozhodl, kde (nebo ILoggercokoliv jiného) a co přesně protokolovat. Implementace by však měla mít na paměti potenciální nežádoucí vedlejší účinky přístupu k některým vlastnostem HttpRequestMessage nebo HttpResponseMessage , například čtení z datového proudu obsahu. Pokud je to možné, měli byste se takovému chování vyhnout.
Implementace protokolování by neměla vyvolat žádné výjimky, protože neošetřená výjimka v protokolování by požadavek selhala.
Metody
| LogRequestFailed(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan) |
Zaznamená výjimku, ke které došlo při odesílání požadavku HTTP. (Zděděno od IHttpClientLogger) |
| LogRequestFailedAsync(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan, CancellationToken) |
Zaznamená výjimku, ke které došlo při odesílání požadavku HTTP. |
| LogRequestStart(HttpRequestMessage) |
Protokoluje před odesláním požadavku HTTP. (Zděděno od IHttpClientLogger) |
| LogRequestStartAsync(HttpRequestMessage, CancellationToken) |
Protokoluje před odesláním požadavku HTTP. |
| LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) |
Protokoluje po přijetí odpovědi HTTP. (Zděděno od IHttpClientLogger) |
| LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) |
Protokoluje po přijetí odpovědi HTTP. |
