IHttpClientAsyncLogger Schnittstelle

Definition

Namespace:

Microsoft.Extensions.Http.Logging

Assembly:

Microsoft.Extensions.Http.dll

Paket:

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

Quelle:

IHttpClientAsyncLogger.cs

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::IHttpClientLogger

public interface IHttpClientAsyncLogger : Microsoft.Extensions.Http.Logging.IHttpClientLogger

type IHttpClientAsyncLogger = interface
    interface IHttpClientLogger

Public Interface IHttpClientAsyncLogger
Implements IHttpClientLogger

Implementiert

IHttpClientLogger

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.