Freigeben über


IHttpClientAsyncLogger Schnittstelle

Definition

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

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.

Gilt für: