ServicePoint.SetTcpKeepAlive(Boolean, Int32, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Включает или отключает параметр поддержания активности в 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-поддержания активности в TCP-подключении будет включен с помощью указанных keepAliveTime
и keepAliveInterval
значений.
Если задано значение false, параметр "Сохранить в режиме жизни TCP" отключен, а остальные параметры игнорируются.
Значение по умолчанию — false.
- keepAliveTime
- Int32
Указывает время ожидания в миллисекундах без действия, пока первый пакет не будет отправлен.
Значение должно быть больше 0. Если значение меньше нуля или равно нулю, создается ArgumentOutOfRangeException.
- keepAliveInterval
- Int32
Указывает интервал (в миллисекундах), между тем, когда последовательные пакеты постоянного хранения отправляются, если подтверждение не получено.
Значение должно быть больше 0. Если значение меньше нуля или равно нулю, создается ArgumentOutOfRangeException.
Исключения
Значение, указанное для параметра keepAliveTime
или keepAliveInterval
, меньше или равно 0.
Комментарии
Осторожность
WebRequest
, HttpWebRequest
, ServicePoint
и WebClient
устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Приложение может запросить, чтобы поставщик TCP/IP мог включить использование пакетов в tcp-подключении. Значением по умолчанию является отключение использования пакетов по протоколу TCP.
Параметры по умолчанию, когда сокет TCP инициализирован, задает время ожидания в режиме поддержания активности в 2 часа, а интервал поддержания активности — 1 секунду. Параметр keepAliveTime
указывает время ожидания в миллисекундах без действия до отправки первого пакета в режиме поддержания активности. Параметр keepAliveInterval
указывает интервал в миллисекундах между отправкой последовательных пакетов в режиме поддержания активности, если подтверждение не получено. Количество проб в режиме поддержания активности не может быть изменено и имеет значение 10.
Если tcp-подключение удаляется в результате поддержания активности, SocketErrorNetworkReset возвращается в любые вызовы, выполняемые в сокете, и все последующие вызовы завершаются сбоем SocketErrorNotConnected.