IHttpClientAsyncLogger Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Eine Abstraktion für die asynchrone benutzerdefinierte HTTP-Anforderungsprotokollierung für benannte HttpClient Instanzen, die von zurückgegeben werden 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- Implementiert
Hinweise
Asynchrone Methoden (z LogRequestStartAsync(HttpRequestMessage, CancellationToken). B. ) werden aus asynchronen Codepfaden (z SendAsync(HttpRequestMessage, CancellationToken). B. ) aufgerufen. Ihre synchronen Entsprechungen, die von IHttpClientLogger geerbt werden (z LogRequestStart(HttpRequestMessage). B. ), werden von den entsprechenden Synchronisierungscodepfaden aufgerufen.
Es liegt am Benutzer, der die Schnittstelle implementiert, zu entscheiden, wo (oder ILoggeretwas anderes) und was genau protokolliert werden soll. Bei der Implementierung sollten jedoch potenzielle nachteilige Nebenwirkungen des Zugriffs auf einige eigenschaften HttpRequestMessage oder HttpResponseMessage beachtet werden, z. B. das Lesen aus einem Inhaltsdatenstrom. Wenn möglich, sollte ein solches Verhalten vermieden werden.
Die Protokollierungsimplementierung sollte keine Ausnahmen auslösen, da bei einer nicht behandelten Ausnahme in der Protokollierung die Anforderung fehlschlägt.
Methoden
| LogRequestFailed(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan) |
Protokolliert die Ausnahme, die beim Senden einer HTTP-Anforderung aufgetreten ist. (Geerbt von IHttpClientLogger) |
| LogRequestFailedAsync(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan, CancellationToken) |
Protokolliert die Ausnahme, die beim Senden einer HTTP-Anforderung aufgetreten ist. |
| LogRequestStart(HttpRequestMessage) |
Protokolliert vor dem Senden einer HTTP-Anforderung. (Geerbt von IHttpClientLogger) |
| LogRequestStartAsync(HttpRequestMessage, CancellationToken) |
Protokolliert vor dem Senden einer HTTP-Anforderung. |
| LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) |
Protokolliert nach dem Empfangen einer HTTP-Antwort. (Geerbt von IHttpClientLogger) |
| LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) |
Protokolliert nach dem Empfangen einer HTTP-Antwort. |
