ServicePointManager.SetTcpKeepAlive(Boolean, Int32, Int32) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 -> unitPublic 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
