ServicePointManager.SetTcpKeepAlive(Boolean, Int32, Int32) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Active ou désactive l'option permettant de maintenir une connexion TCP active.
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)Paramètres
- enabled
- Boolean
Si la valeur est true, l’option de persistance (KeepAlive) du TCP sur une connexion TCP sera activée à l’aide des valeurs keepAliveTime et keepAliveInterval spécifiées.
Si la valeur est false, l'option de persistance du TCP est désactivée et les paramètres restants sont ignorés.
La valeur par défaut est false.
- keepAliveTime
- Int32
Spécifie le délai d'attente, en millisecondes, sans activité jusqu'à l'envoi du premier paquet persistant.
La valeur doit être supérieure à 0. Si une valeur inférieure ou égale à zéro est passée, une exception ArgumentOutOfRangeException est levée.
- keepAliveInterval
- Int32
Spécifie l'intervalle, en millisecondes, entre les envois des paquets persistants si aucun accusé de réception n'est reçu.
La valeur doit être supérieure à 0. Si une valeur inférieure ou égale à zéro est passée, une exception ArgumentOutOfRangeException est levée.
Exceptions
La valeur spécifiée pour le paramètre keepAliveTime ou keepAliveInterval est inférieure ou égale à 0.
Remarques
Une application peut demander à un fournisseur TCP/IP d’activer l’utilisation de paquets keep-alive sur une connexion TCP. La valeur par défaut est que l’utilisation de paquets keep-alive sur une connexion TCP est désactivée.
Les paramètres par défaut lorsqu’un socket TCP est initialisé définissent le délai d’attente keep-alive sur 2 heures et l’intervalle de conservation sur 1 seconde. Le keepAliveTime paramètre spécifie le délai d’attente, en millisecondes, sans activité tant que le premier paquet keep-alive n’est pas envoyé. Le keepAliveInterval paramètre spécifie l’intervalle, en millisecondes, entre l’envoi de paquets de conservation successifs si aucun accusé de réception n’est reçu. Le nombre de sondes keep-alive ne peut pas être modifié et est défini sur 10.
Si une connexion TCP est supprimée à la suite de conservations actives, un SocketError de NetworkReset est retourné à tous les appels en cours sur le socket, et tous les appels suivants échouent avec un SocketError de NotConnected.
