HttpClientBuilderExtensions.SetHandlerLifetime Metode

Definisi

Ruang nama:

Microsoft.Extensions.DependencyInjection

Rakitan:

Microsoft.Extensions.Http.dll

Paket:

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

Sumber:

HttpClientBuilderExtensions.cs

Mengatur lamanya waktu instans HttpMessageHandler dapat digunakan kembali. Setiap klien bernama dapat memiliki nilai masa pakai handler yang dikonfigurasi sendiri. Nilai defaultnya adalah dua menit. Atur masa pakai ke InfiniteTimeSpan untuk menonaktifkan kedaluwarsa penanganan.

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ SetHandlerLifetime(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder, TimeSpan handlerLifetime);

public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder SetHandlerLifetime (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, TimeSpan handlerLifetime);

static member SetHandlerLifetime : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * TimeSpan -> Microsoft.Extensions.DependencyInjection.IHttpClientBuilder

<Extension()>
Public Function SetHandlerLifetime (builder As IHttpClientBuilder, handlerLifetime As TimeSpan) As IHttpClientBuilder

Parameter

builder

IHttpClientBuilder

handlerLifetime

TimeSpan

Mengembalikan

IHttpClientBuilder

Keterangan

Implementasi IHttpClientFactory default akan mengumpulkan HttpMessageHandler instans yang dibuat oleh pabrik untuk mengurangi konsumsi sumber daya. Pengaturan ini mengonfigurasi jumlah waktu handler dapat dikumpulkan sebelum dijadwalkan untuk dihapus dari kumpulan dan pembuangan.

Pengumpulan penanganan diinginkan karena setiap penanganan biasanya mengelola sambungan HTTP yang mendasarinya sendiri; membuat lebih banyak penanganan dibandingkan yang diperlukan dapat mengakibatkan penundaan sambungan. Beberapa handler juga menjaga koneksi tetap terbuka tanpa batas waktu yang dapat mencegah handler bereaksi terhadap perubahan DNS. Nilai handlerLifetime harus dipilih dengan pemahaman tentang persyaratan aplikasi untuk merespons perubahan di lingkungan jaringan.

Kedaluwarsa handler tidak akan segera membuang handler. Handler yang kedaluwarsa ditempatkan di kumpulan terpisah yang diproses pada interval untuk membuang handler hanya ketika mereka menjadi tidak dapat dijangkau. Menggunakan instans berumur HttpClient panjang akan mencegah yang mendasar HttpMessageHandler dibuang sampai semua referensi dikumpulkan dari sampah.