Udostępnij za pośrednictwem


ServicePointManager.SetTcpKeepAlive(Boolean, Int32, Int32) Metoda

Definicja

Włącza lub wyłącza opcję utrzymania aktywności w połączeniu 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)

Parametry

enabled
Boolean

Jeśli ustawiono wartość true, opcja utrzymywania aktywności protokołu TCP w połączeniu TCP zostanie włączona przy użyciu określonych keepAliveTime wartości i keepAliveInterval .

Jeśli ustawiono wartość false, opcja zachowaj żywość protokołu TCP jest wyłączona, a pozostałe parametry są ignorowane.

Wartość domyślna to false.

keepAliveTime
Int32

Określa limit czasu ( w milisekundach) bez działania do momentu wysłania pierwszego pakietu keep-alive.

Wartość musi być większa niż 0. Jeśli zostanie przekazana wartość mniejsza niż lub równa zero, ArgumentOutOfRangeException zostanie zwrócona wartość .

keepAliveInterval
Int32

Określa interwał w milisekundach między kolejnymi pakietami utrzymania aktywności, jeśli nie odebrano potwierdzenia.

Wartość musi być większa niż 0. Jeśli zostanie przekazana wartość mniejsza niż lub równa zero, ArgumentOutOfRangeException zostanie zwrócona wartość .

Wyjątki

Wartość określona dla keepAliveTime parametru lub keepAliveInterval jest mniejsza niż lub równa 0.

Uwagi

Aplikacja może zażądać, aby dostawca PROTOKOŁU TCP/IP włączył korzystanie z pakietów utrzymywania aktywności w połączeniu TCP. Ustawieniem domyślnym jest to, że użycie pakietów utrzymywania aktywności w połączeniu TCP jest wyłączone.

Ustawienia domyślne, gdy gniazdo TCP jest inicjowane, ustawia limit czasu utrzymania aktywności na 2 godziny i interwał utrzymania aktywności do 1 sekundy. Parametr keepAliveTime określa limit czasu ( w milisekundach) bez działania do momentu wysłania pierwszego pakietu keep-alive. Parametr keepAliveInterval określa interwał w milisekundach między kolejnymi pakietami utrzymania aktywności, jeśli nie odebrano potwierdzenia. Nie można zmienić liczby sond utrzymania aktywności i jest ustawiona na 10.

Jeśli połączenie TCP zostanie porzucone w wyniku utrzymania aktywności, element SocketError z zostanie zwrócony do wszelkich wywołań w toku w gniazdie, a wszystkie kolejne wywołania zakończy się niepowodzeniem z wartością SocketErrorNotConnected.NetworkReset

Dotyczy

Zobacz też