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 資料庫端點。