ServicePointManager.SetTcpKeepAlive(Boolean, Int32, Int32) 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.
Mengaktifkan atau menonaktifkan opsi tetap hidup pada koneksi TCP.
public:
static void SetTcpKeepAlive(bool enabled, int keepAliveTime, int keepAliveInterval);public static void SetTcpKeepAlive (bool enabled, int keepAliveTime, int keepAliveInterval);static member SetTcpKeepAlive : bool * int * int -> unitPublic Shared Sub SetTcpKeepAlive (enabled As Boolean, keepAliveTime As Integer, keepAliveInterval As Integer)Parameter
- enabled
- Boolean
Jika diatur ke true, maka opsi TCP keep-alive pada koneksi TCP akan diaktifkan menggunakan nilai dan keepAliveInterval yang ditentukankeepAliveTime.
Jika diatur ke false, maka opsi TCP keep-alive dinonaktifkan dan parameter yang tersisa diabaikan.
Nilai defaultnya adalah false.
- keepAliveTime
- Int32
Menentukan batas waktu, dalam milidetik, tanpa aktivitas hingga paket tetap aktif pertama dikirim.
Nilai harus lebih besar dari 0. Jika nilai kurang dari atau sama dengan nol dilewatkan, akan dilemparkan ArgumentOutOfRangeException .
- keepAliveInterval
- Int32
Menentukan interval, dalam milidetik, antara kapan paket keep-alive berturut-turut dikirim jika tidak ada pengakuan yang diterima.
Nilai harus lebih besar dari 0. Jika nilai kurang dari atau sama dengan nol dilewatkan, akan dilemparkan ArgumentOutOfRangeException .
Pengecualian
Nilai yang ditentukan untuk keepAliveTime parameter atau keepAliveInterval kurang dari atau sama dengan 0.
Keterangan
Aplikasi dapat meminta penyedia TCP/IP mengaktifkan penggunaan paket tetap aktif pada koneksi TCP. Defaultnya adalah bahwa penggunaan paket tetap hidup pada koneksi TCP dinonaktifkan.
Pengaturan default saat soket TCP diinisialisasi mengatur batas waktu tetap hidup menjadi 2 jam dan interval tetap hidup menjadi 1 detik. Parameter keepAliveTime menentukan batas waktu, dalam milidetik, tanpa aktivitas hingga paket tetap aktif pertama dikirim. Parameter keepAliveInterval menentukan interval, dalam milidetik, antara ketika paket keep-alive berturut-turut dikirim jika tidak ada pengakuan yang diterima. Jumlah pemeriksaan tetap hidup tidak dapat diubah dan diatur ke 10.
Jika koneksi TCP dihilangkan sebagai akibat dari tetap hidup, SocketError satu dari NetworkReset dikembalikan ke panggilan apa pun yang sedang berlangsung di soket, dan panggilan berikutnya akan gagal dengan SocketError dari NotConnected.
