ServicePoint.SetTcpKeepAlive(Boolean, Int32, Int32) Метод

Определение

Пространство имен:

System.Net

Сборка:

System.Net.ServicePoint.dll

Исходный код:

ServicePoint.cs

Включает или отключает параметр поддержания активности соединения TCP.

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)

Параметры

enabled

Boolean

Если этот параметр имеет значение true, параметр поддержания активности соединения TCP будет включен с помощью указанных значений keepAliveTime и keepAliveInterval.

Если этот параметр имеет значение false, параметр поддержания активности TCP отключен, и остальные параметры игнорируются.

Значением по умолчанию является false.

keepAliveTime

Int32

Задает время ожидания в миллисекундах при отсутствии активности до отправки первого пакета поддержания активности.

Значение должно быть больше нуля. При передаче значения, меньшего или равного нулю, возникает исключение ArgumentOutOfRangeException.

keepAliveInterval

Int32

Задает интервал в миллисекундах между успешной отправкой пакетов поддержания активности в случае отсутствия подтверждения.

Значение должно быть больше нуля. При передаче значения, меньшего или равного нулю, возникает исключение ArgumentOutOfRangeException.

Исключения

ArgumentOutOfRangeException

Значение параметра keepAliveTime или keepAliveInterval меньше или равно 0.

Комментарии

Приложение может запросить, чтобы поставщик TCP/IP включил использование пакетов поддержания активности в TCP-подключении. По умолчанию использование пакетов поддержания активности в TCP-подключении отключено.

Параметры по умолчанию при инициализации сокета TCP устанавливают время ожидания поддержания активности в 2 часа, а интервал поддержания активности — 1 секунду. Параметр keepAliveTime задает время ожидания (в миллисекундах) без действия до отправки первого пакета для поддержания активности. Параметр keepAliveInterval задает интервал в миллисекундах между отправкой последовательных пакетов поддержания активности, если подтверждение не получено. Количество проб поддержания активности невозможно изменить. Для этого задано значение 10.

Если TCP-подключение будет удалено в результате поддержания активности, SocketErrorNetworkReset объект возвращается для всех вызовов, которые выполняются в сокете, и все последующие вызовы завершаются ошибкой SocketErrorNotConnectedс .