SqlConnectionStringBuilder.LoadBalanceTimeout プロパティ

定義

名前空間:

Microsoft.Data.SqlClient

アセンブリ:

Microsoft.Data.SqlClient.dll

パッケージ:

Microsoft.Data.SqlClient v5.2.0

接続プールに維持されている接続が破棄されるまでの最短時間 (秒単位) を取得または設定します。

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

public int LoadBalanceTimeout { get; set; }

member this.LoadBalanceTimeout : int with get, set

Public Property LoadBalanceTimeout As Integer

プロパティ値

Int32

LoadBalanceTimeout プロパティの値。値が指定されていない場合は 0。

注釈

このプロパティは、接続文字列内の "Load Balance Timeout" キーおよび "connection lifetime" キーに対応しています。

接続がプールに返された時点で、その接続の作成時刻と現在の時刻を比較し、その時間の長さ (秒) が Connection Lifetime で指定した値を超えている場合は、その接続が破棄されます。 これは、クラスター構成を採用している状況で、実行中のサーバーと、オンラインになったばかりのサーバーの間での、負荷を強制的に分散するのに便利です。

値が 0 の場合、プールされた接続の最大接続タイムアウトが発生します。