ServicePointManager.SetTcpKeepAlive(Boolean, Int32, Int32) Metode

Referensi

Definisi

Ruang nama:: System.Net

Rakitan:: System.Net.ServicePoint.dll

Rakitan:: System.Net.Requests.dll

Rakitan:: System.dll

Rakitan:: netstandard.dll

Sumber:: ServicePointManager.cs

Sumber:: ServicePointManager.cs

Sumber:: ServicePointManager.cs

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 -> unit

Public 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

ArgumentOutOfRangeException

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.

Berlaku untuk

Lihat juga

ServicePoint

Bagikan melalui