HttpClientBuilderExtensions.SetHandlerLifetime 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.
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
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.