HttpClientBuilderExtensions.AddLogger Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean) |
Menambahkan delegasi yang akan digunakan untuk membuat pencatat tambahan untuk yang bernama HttpClient. Pencatat kustom akan dipanggil dari pencatatan khusus DelegatingHandler pada setiap permintaan yang sesuai bernama HttpClient. |
AddLogger<TLogger>(IHttpClientBuilder, Boolean) |
Menambahkan delegasi yang akan digunakan untuk membuat pencatat tambahan untuk yang bernama HttpClient. Pencatat kustom akan dipanggil dari pencatatan khusus DelegatingHandler pada setiap permintaan yang sesuai bernama HttpClient. |
AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean)
Menambahkan delegasi yang akan digunakan untuk membuat pencatat tambahan untuk yang bernama HttpClient. Pencatat kustom akan dipanggil dari pencatatan khusus DelegatingHandler pada setiap permintaan yang sesuai bernama HttpClient.
public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddLogger (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, Func<IServiceProvider,Microsoft.Extensions.Http.Logging.IHttpClientLogger> httpClientLoggerFactory, bool wrapHandlersPipeline = false);
static member AddLogger : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * Func<IServiceProvider, Microsoft.Extensions.Http.Logging.IHttpClientLogger> * bool -> Microsoft.Extensions.DependencyInjection.IHttpClientBuilder
<Extension()>
Public Function AddLogger (builder As IHttpClientBuilder, httpClientLoggerFactory As Func(Of IServiceProvider, IHttpClientLogger), Optional wrapHandlersPipeline As Boolean = false) As IHttpClientBuilder
Parameter
- builder
- IHttpClientBuilder
- httpClientLoggerFactory
- Func<IServiceProvider,IHttpClientLogger>
Delegasi yang digunakan untuk membuat pencatat kustom. Pencatat harus mengimplementasikan IHttpClientLogger atau IHttpClientAsyncLogger.
- wrapHandlersPipeline
- Boolean
true
untuk menambahkan penangan pengelogan dengan pencatat kustom ke awal rantai handler tambahan; false
untuk menambahkannya ke akhir rantai.
Mengembalikan
Yang IHttpClientBuilder dapat digunakan untuk mengonfigurasi klien.
Keterangan
Jika wrapHandlersPipeline
'true', LogRequestStart(HttpRequestMessage) dan LogRequestStartAsync(HttpRequestMessage, CancellationToken) akan dijalankan sebelum semua handler tambahan lainnya dalam rantai.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) dan LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) akan dijalankan setelah semua handler tambahan lainnya, pada dasarnya membungkus seluruh alur.
Jika wrapHandlersPipeline
'false', LogRequestStart(HttpRequestMessage) dan LogRequestStartAsync(HttpRequestMessage, CancellationToken) akan dijalankan setelah semua handler tambahan lainnya dalam rantai, tepat sebelum handler utama.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) dan LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) akan dijalankan sebelum semua handler tambahan lainnya, tepat setelah handler utama.
Argumen IServiceProvider yang diberikan untuk httpClientLoggerFactory
akan menjadi referensi ke penyedia layanan terlingkup yang berbagi masa pakai rantai handler yang sedang dibangun.
Jika AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean) dipanggil beberapa kali, beberapa pencatat akan ditambahkan. Jika RemoveAllLoggers(IHttpClientBuilder) tidak dipanggil sebelum memanggil AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean), maka pencatat baru akan ditambahkan selain yang default.
Berlaku untuk
AddLogger<TLogger>(IHttpClientBuilder, Boolean)
Menambahkan delegasi yang akan digunakan untuk membuat pencatat tambahan untuk yang bernama HttpClient. Pencatat kustom akan dipanggil dari pencatatan khusus DelegatingHandler pada setiap permintaan yang sesuai bernama HttpClient.
public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddLogger<TLogger> (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, bool wrapHandlersPipeline = false) where TLogger : Microsoft.Extensions.Http.Logging.IHttpClientLogger;
static member AddLogger : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * bool -> Microsoft.Extensions.DependencyInjection.IHttpClientBuilder (requires 'Logger :> Microsoft.Extensions.Http.Logging.IHttpClientLogger)
<Extension()>
Public Function AddLogger(Of TLogger As IHttpClientLogger) (builder As IHttpClientBuilder, Optional wrapHandlersPipeline As Boolean = false) As IHttpClientBuilder
Jenis parameter
- TLogger
Jenis layanan pencatat kustom seperti yang terdaftar di DI. Pencatat harus mengimplementasikan IHttpClientLogger atau IHttpClientAsyncLogger.
Parameter
- builder
- IHttpClientBuilder
- wrapHandlersPipeline
- Boolean
true
untuk menambahkan penangan pengelogan dengan pencatat kustom ke awal rantai handler tambahan; false
untuk menambahkannya ke akhir rantai.
Mengembalikan
Yang IHttpClientBuilder dapat digunakan untuk mengonfigurasi klien.
Keterangan
Jika wrapHandlersPipeline
'true', LogRequestStart(HttpRequestMessage) dan LogRequestStartAsync(HttpRequestMessage, CancellationToken) akan dijalankan sebelum semua handler tambahan lainnya dalam rantai.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) dan LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) akan dijalankan setelah semua handler tambahan lainnya, pada dasarnya membungkus seluruh alur.
Jika wrapHandlersPipeline
'false', LogRequestStart(HttpRequestMessage) dan LogRequestStartAsync(HttpRequestMessage, CancellationToken) akan dijalankan setelah semua handler tambahan lainnya dalam rantai, tepat sebelum handler utama.
LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) dan LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) akan dijalankan sebelum semua handler tambahan lainnya, tepat setelah handler utama.
TLogger
akan diselesaikan dari penyedia layanan terlingkup yang berbagi masa pakai rantai handler yang sedang dibangun.
Jika AddLogger<TLogger>(IHttpClientBuilder, Boolean) dipanggil beberapa kali, beberapa pencatat akan ditambahkan. Jika RemoveAllLoggers(IHttpClientBuilder) tidak dipanggil sebelum memanggil AddLogger<TLogger>(IHttpClientBuilder, Boolean), maka pencatat baru akan ditambahkan selain yang default.