SqlConnectionStringBuilder.IdleTimeout 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置连接在放弃连接池之前,连接可以处于未使用状态(空闲)的最大时间(以秒为单位)。 默认值为 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运行。 首先超过哪个阈值会导致连接被丢弃。