ServicePoint.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 keep-alive sur une connexion 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 -> unitPublic Sub SetTcpKeepAlive (enabled As Boolean, keepAliveTime As Integer, keepAliveInterval As Integer)Paramètres
- enabled
- Boolean
Si la valeur est true, l’option de conservation TCP sur une connexion TCP est activée à l’aide des valeurs keepAliveTime et keepAliveInterval spécifiées.
Si la valeur est false, l’option tcp keep-alive 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’expiration, en millisecondes, sans activité tant que le premier paquet keep-alive n’est pas envoyé.
La valeur doit être supérieure à 0. Si une valeur inférieure ou égale à zéro est passée à un ArgumentOutOfRangeException est levée.
- keepAliveInterval
- Int32
Spécifie l’intervalle, en millisecondes, entre le moment où les paquets continus successifs sont envoyés 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 à un ArgumentOutOfRangeException est levée.
Exceptions
La valeur spécifiée pour le paramètre keepAliveTime ou keepAliveInterval est inférieure ou égale à 0.
Remarques
Prudence
WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.
Une application peut demander à un fournisseur TCP/IP d’utiliser des 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 de conservation en vie sur 2 heures et l’intervalle de conservation active sur 1 seconde. Le paramètre keepAliveTime spécifie le délai d’expiration, en millisecondes, sans activité tant que le premier paquet de conservation n’est pas envoyé. Le paramètre keepAliveInterval spécifie l’intervalle, en millisecondes, entre le moment où les paquets de conservation successifs sont envoyés 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 suite à des conservations actives, une SocketError de NetworkReset est retournée à tous les appels en cours sur le socket, et les appels suivants échouent avec un SocketError de NotConnected.
