IHttpClientAsyncLogger Antarmuka

Definisi

Ruang nama:

Microsoft.Extensions.Http.Logging

Rakitan:

Microsoft.Extensions.Http.dll

Paket:

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

Sumber:

IHttpClientAsyncLogger.cs

Abstraksi untuk pengelogan permintaan HTTP kustom asinkron untuk instans bernama HttpClient yang dikembalikan oleh 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

Penerapan

IHttpClientLogger

Keterangan

Metode asinkron (seperti LogRequestStartAsync(HttpRequestMessage, CancellationToken)) dipanggil dari jalur kode asinkron (seperti SendAsync(HttpRequestMessage, CancellationToken)). Rekan sinkron mereka yang diwarisi dari IHttpClientLogger (seperti LogRequestStart(HttpRequestMessage)) dipanggil dari jalur kode sinkronisasi yang sesuai.

Terserah pengguna yang mengimplementasikan antarmuka untuk memutuskan di mana (ke ILogger, atau apa pun) dan apa sebenarnya yang harus dicatat. Namun, implementasinya harus memperhatikan potensi efek samping yang merugikan dari mengakses beberapa HttpRequestMessage properti atau HttpResponseMessage , seperti membaca dari aliran konten. Jika memungkinkan, perilaku tersebut harus dihindari.

Implementasi pengelogan tidak boleh melemparkan pengecualian apa pun, karena pengecualian yang tidak tertangani dalam pengelogan akan gagal dalam permintaan.

Metode

LogRequestFailed(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan)	Mencatat pengecualian yang terjadi saat mengirim permintaan HTTP. (Diperoleh dari IHttpClientLogger)
LogRequestFailedAsync(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan, CancellationToken)	Mencatat pengecualian yang terjadi saat mengirim permintaan HTTP.
LogRequestStart(HttpRequestMessage)	Log sebelum mengirim permintaan HTTP. (Diperoleh dari IHttpClientLogger)
LogRequestStartAsync(HttpRequestMessage, CancellationToken)	Log sebelum mengirim permintaan HTTP.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan)	Log setelah menerima respons HTTP. (Diperoleh dari IHttpClientLogger)
LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken)	Log setelah menerima respons HTTP.