ServicePointManager.SetTcpKeepAlive(Boolean, Int32, Int32) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Net

Zestaw:: System.Net.ServicePoint.dll

Zestaw:: System.Net.Requests.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Źródło:: ServicePointManager.cs

Źródło:: ServicePointManager.cs

Źródło:: ServicePointManager.cs

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

ArgumentOutOfRangeException

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ą SocketError NotConnected.NetworkReset

Dotyczy

Zobacz też

ServicePoint