语言

SqlConnectionStringBuilder.IdleTimeout 属性

定义

获取或设置连接在放弃连接池之前,连接可以处于未使用状态(空闲)的最大时间(以秒为单位)。 默认值为 300 (5 分钟)。

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

属性值

共用连接的空闲超时(以秒为单位)。

注解

此属性对应于连接字符串中的“连接空闲超时”键。

在启用 AppContext 开关 Switch.Microsoft.Data.SqlClient.UseLegacyIdleTimeoutBehavior 的版本(默认值)中,驱动程序会保留历史池行为,并且不强制实施此设置。 将开关设置为 false 启用空闲超时强制。

驱动程序尽力放弃池中保持空闲状态的连接的时间超过此值。 检查发生的连接生命周期中的确切点是实现详细信息,可能会随时间而变化。 这样可以防止调用方接收防火墙、负载均衡器或服务器端非活动阈值以无提示方式关闭的连接。

值为零(0)会禁用空闲过期;连接无限期保留在池中(受其他过期规则(例如 LoadBalanceTimeout) 的约束。

空闲超时独立于 LoadBalanceTimeout运行。 首先超过哪个阈值会导致连接被丢弃。

适用于