ServicePoint.SetTcpKeepAlive(Boolean, Int32, Int32) Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.ServicePoint.dll

Sumber:

ServicePoint.cs

Mengaktifkan atau menonaktifkan opsi tetap hidup pada koneksi TCP.

public:
 void SetTcpKeepAlive(bool enabled, int keepAliveTime, int keepAliveInterval);

public void SetTcpKeepAlive (bool enabled, int keepAliveTime, int keepAliveInterval);

member this.SetTcpKeepAlive : bool * int * int -> unit

Public 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 keepAliveTime dan keepAliveInterval yang ditentukan.

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 hidup pertama dikirim.

Nilai harus lebih besar dari 0. Jika nilai kurang dari atau sama dengan nol dilewatkan ArgumentOutOfRangeException dilemparkan.

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 ArgumentOutOfRangeException dilemparkan.

Pengecualian

ArgumentOutOfRangeException

Nilai yang ditentukan untuk parameter keepAliveTime atau keepAliveInterval kurang dari atau sama dengan 0.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

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 hidup 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, SocketErrorNetworkReset dikembalikan ke panggilan apa pun yang sedang berlangsung pada soket, dan setiap panggilan berikutnya akan gagal dengan SocketErrorNotConnected.