SqlConnectionStringBuilder.ConnectRetryCount 属性

定义

命名空间:

Microsoft.Data.SqlClient

程序集:

Microsoft.Data.SqlClient.dll

包:

Microsoft.Data.SqlClient v5.2.0

在确定有一个空闲的连接失败之后尝试重新连接的次数。 该值必须是介于 0 和 255 之间的整数。 非 Azure 终结点的默认值为 1。 对于Azure SQL终结点，默认值为 2。 从版本 5.x 开始，对于Azure SQL无服务器或按需终结点，默认值为 5，以提高连接到空闲或暂停实例的连接成功率。 设置为 0 将禁止在空闲连接失败时重新连接。 如果设置的值超过允许的范围，则将引发 ArgumentException。

public:
 property int ConnectRetryCount { int get(); void set(int value); };

public int ConnectRetryCount { get; set; }

member this.ConnectRetryCount : int with get, set

Public Property ConnectRetryCount As Integer

属性值

Int32

在确定有一个空闲的连接失败之后尝试重新连接的次数。

注解

此属性对应于连接字符串中的SqlConnection“连接重试计数”键。

注意

自版本 5.x 起，无 Azure 终结点的默认值为 1，对于Azure SQL，Azure Synapse已增加到 2 和 5，以针对高需求 Azure 终结点实现恢复。 应首先检测它，并且可以将 Synapse 检测为常规Azure SQL数据库终结点。