IHttpClientAsyncLogger Interfaccia
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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::IHttpClientLoggerpublic interface IHttpClientAsyncLogger : Microsoft.Extensions.Http.Logging.IHttpClientLoggertype IHttpClientAsyncLogger = interface
interface IHttpClientLoggerPublic Interface IHttpClientAsyncLogger
Implements IHttpClientLogger- Implementazioni
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. |
