IHttpClientAsyncLogger Interfaccia

Definizione

Spazio dei nomi:

Microsoft.Extensions.Http.Logging

Assembly:

Microsoft.Extensions.Http.dll

Pacchetto:

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

Origine:

IHttpClientAsyncLogger.cs

Astrazione per la registrazione di richieste HTTP personalizzate asincrone per le istanze denominate HttpClient restituite da 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

Implementazioni

IHttpClientLogger

Commenti

I metodi asincroni (ad esempio LogRequestStartAsync(HttpRequestMessage, CancellationToken)) vengono chiamati da percorsi di codice asincroni ( ad esempio SendAsync(HttpRequestMessage, CancellationToken)). Le controparti sincrone ereditate da IHttpClientLogger (ad esempio LogRequestStart(HttpRequestMessage)) vengono chiamate dai percorsi di codice di sincronizzazione corrispondenti.

Spetta all'utente che implementa l'interfaccia per decidere dove (per ILoggero qualsiasi altro) e cosa registrare esattamente. Tuttavia, l'implementazione deve essere consapevole dei potenziali effetti collaterali negativi dell'accesso HttpRequestMessage ad alcune proprietà o HttpResponseMessage , ad esempio la lettura da un flusso di contenuto. Se possibile, è consigliabile evitare questo comportamento.

L'implementazione della registrazione non deve generare eccezioni, perché un'eccezione non gestita nella registrazione non riuscirà a eseguire la richiesta.

Metodi

LogRequestFailed(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan)	Registra l'eccezione che si è verificata durante l'invio di una richiesta HTTP. (Ereditato da IHttpClientLogger)
LogRequestFailedAsync(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan, CancellationToken)	Registra l'eccezione che si è verificata durante l'invio di una richiesta HTTP.
LogRequestStart(HttpRequestMessage)	Registra prima di inviare una richiesta HTTP. (Ereditato da IHttpClientLogger)
LogRequestStartAsync(HttpRequestMessage, CancellationToken)	Registra prima di inviare una richiesta HTTP.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan)	Registra dopo aver ricevuto una risposta HTTP. (Ereditato da IHttpClientLogger)
LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken)	Registra dopo aver ricevuto una risposta HTTP.