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では、需要の高い Azure エンドポイントに対する復旧を妨げるため、2 と 5 に増加しています。 最初に検出する必要があり、Synapse は通常の Azure SQL DB エンドポイントとして検出される可能性があります。