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 asynchrone benutzerdefinierte HTTP-Anforderungsprotokollierung für eine benannte HttpClient Instanz, die von 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. ) würden von asynchronen Codepfaden (z SendAsync(HttpRequestMessage, CancellationToken). B. ) aufgerufen, und ihre syncronous-Entsprechungen, die von IHttpClientLogger (z LogRequestStart(HttpRequestMessage). B. ) geerbt wurden, würden von den entsprechenden Synchronisierungscodepfaden aufgerufen.
Es liegt an der Benutzer, die die Benutzeroberfläche implementiert, um zu entscheiden, ob die Schnittstelle verwendet ILoggerwerden soll, oder etwas anderes, und was genau protokolliert werden soll. Die Implementierung sollte sich jedoch über mögliche nachteilige Nebenwirkungen des Zugriffs auf einige der HttpRequestMessage Eigenschaften oder HttpResponseMessage Eigenschaften, z. B. das Lesen aus einem Inhaltsdatenstrom, informieren. Wenn möglich, sollte ein solches Verhalten vermieden werden.
Die Protokollierungsimplementierung sollte auch keine Ausnahmen auslösen, da eine unbehandelte Ausnahme bei der Protokollierung die Anforderung fehlschlägt.
Methoden
| Name | Beschreibung |
|---|---|
| LogRequestFailed(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan) |
Protokolliert die Ausnahme beim Senden einer HTTP-Anforderung. (Geerbt von IHttpClientLogger) |
| LogRequestFailedAsync(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan, CancellationToken) |
Protokolliert die Ausnahme beim Senden einer HTTP-Anforderung. |
| LogRequestStart(HttpRequestMessage) |
Protokolle vor dem Senden einer HTTP-Anforderung. (Geerbt von IHttpClientLogger) |
| LogRequestStartAsync(HttpRequestMessage, CancellationToken) |
Protokolle vor dem Senden einer HTTP-Anforderung. |
| LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) |
Protokolle nach dem Empfang einer HTTP-Antwort. (Geerbt von IHttpClientLogger) |
| LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) |
Protokolle nach dem Empfang einer HTTP-Antwort. |
