Langue

SqlConnectionStringBuilder.IdleTimeout Propriété

Définition

Obtient ou définit la durée maximale, en secondes, qu’une connexion peut rester inutilisée (inactive) dans le pool de connexions avant d’être ignorée. La valeur par défaut est 300 (5 minutes).

public:
 property int IdleTimeout { int get(); void set(int value); };
public int IdleTimeout { get; set; }
member this.IdleTimeout : int with get, set
Public Property IdleTimeout As Integer

Valeur de propriété

Délai d’inactivité des connexions mises en pool, en secondes.

Remarques

Cette propriété correspond à la clé « Délai d’inactivité de connexion » dans le chaîne de connexion.

Dans les versions où le commutateur Switch.Microsoft.Data.SqlClient.UseLegacyIdleTimeoutBehavior AppContext est activé (valeur par défaut), le pilote conserve le comportement de regroupement historique et n’applique pas ce paramètre. Définissez le commutateur pour false activer l’application du délai d’inactivité.

Le pilote fait un meilleur effort pour ignorer les connexions qui sont restées inactives dans le pool pendant plus longtemps que cette valeur. Le point exact dans le cycle de vie de connexion auquel la vérification se produit est un détail d’implémentation et peut changer au fil du temps. Cela protège les appelants de la réception des connexions qui ont peut-être été fermées en mode silencieux par des pare-feu, des équilibreurs de charge ou des seuils d’inactivité côté serveur.

La valeur zéro (0) désactive l’expiration inactive ; les connexions sont conservées indéfiniment dans le pool (sous réserve d’autres règles d’expiration telles que LoadBalanceTimeout).

Le délai d’inactivité fonctionne indépendamment de LoadBalanceTimeout. Quel que soit le seuil dépassé, la connexion est ignorée en premier.

S’applique à