HttpClientBuilderExtensions.AddLogger Metode

Definisi

Ruang nama:

Microsoft.Extensions.DependencyInjection

Rakitan:

Microsoft.Extensions.Http.dll

Paket:

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

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)

Sumber:

HttpClientBuilderExtensions.Logging.cs

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

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

IHttpClientBuilder

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.

AddLogger<TLogger>(IHttpClientBuilder, Boolean)

Sumber:

HttpClientBuilderExtensions.Logging.cs

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

IHttpClientBuilder.

wrapHandlersPipeline

Boolean

true untuk menambahkan penangan pengelogan dengan pencatat kustom ke awal rantai handler tambahan; false untuk menambahkannya ke akhir rantai.

Mengembalikan

IHttpClientBuilder

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.