ServicePoint.SetTcpKeepAlive(Boolean, Int32, Int32) Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.ServicePoint.dll

Kaynak:

ServicePoint.cs

TCP bağlantısında etkin tutma seçeneğini etkinleştirir veya devre dışı bırakır.

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)

Parametreler

enabled

Boolean

true olarak ayarlanırsa, tcp bağlantısındaki TCP etkin tutma seçeneği belirtilen keepAliveTime ve keepAliveInterval değerleri kullanılarak etkinleştirilir.

false olarak ayarlanırsa TCP etkin tutma seçeneği devre dışı bırakılır ve kalan parametreler yoksayılır.

Varsayılan değer false'tur.

keepAliveTime

Int32

İlk etkin tutma paketi gönderilene kadar etkinlik olmadan zaman aşımını milisaniye cinsinden belirtir.

Değer 0'dan büyük olmalıdır. Sıfırdan küçük veya sıfıra eşit bir değer geçirilirse bir ArgumentOutOfRangeException oluşturulur.

keepAliveInterval

Int32

Onay alınmadığında birbirini izleyen etkin tutma paketlerinin gönderilmesi arasındaki aralığı milisaniye olarak belirtir.

Değer 0'dan büyük olmalıdır. Sıfırdan küçük veya sıfıra eşit bir değer geçirilirse bir ArgumentOutOfRangeException oluşturulur.

Özel durumlar

ArgumentOutOfRangeException

veya keepAliveInterval parametresi için keepAliveTime belirtilen değer 0'dan küçük veya buna eşit.

Açıklamalar

Bir uygulama bir TCP/IP sağlayıcısının TCP bağlantısında etkin tutma paketlerinin kullanımını etkinleştirmesini isteyebilir. Varsayılan değer, TCP bağlantısında etkin tutma paketlerinin kullanımı devre dışıdır.

TCP yuvası başlatıldığında varsayılan ayarlar, etkin tutma zaman aşımını 2 saat ve canlı tutma aralığını 1 saniye olarak ayarlar. keepAliveTime parametresi, ilk etkin tutma paketi gönderilene kadar etkinlik olmadan milisaniye cinsinden zaman aşımını belirtir. keepAliveInterval parametresi, onay alınmadığında ardışık etkin tutma paketlerinin gönderilmesi arasındaki aralığı milisaniye olarak belirtir. Etkin tutma yoklamalarının sayısı değiştirilemez ve 10 olarak ayarlanır.

Etkin tutma işlemleri sonucunda tcp bağlantısı bırakılırsa, yuvada devam eden tüm çağrılara bir SocketErrorNetworkReset değeri döndürülür ve sonraki tüm çağrılar ile SocketErrorNotConnectedbaşarısız olur.