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, setPublic Property IdleTimeout As Integerプロパティ値
プールされた接続のアイドル タイムアウト (秒単位)。
注釈
このプロパティは、接続文字列内の "接続アイドル タイムアウト" キーに対応します。
AppContext スイッチ Switch.Microsoft.Data.SqlClient.UseLegacyIdleTimeoutBehavior が有効になっているバージョン (既定) では、ドライバーはプール動作の履歴を保持し、この設定は適用しません。 アイドル タイムアウトの適用を有効にするには、スイッチを false に設定します。
ドライバーは、この値よりも長い間プールでアイドル状態のままの接続を破棄するベスト エフォートを行います。 チェックが行われる接続ライフサイクルの正確なポイントは実装の詳細であり、時間の経過と伴って変化する可能性があります。 これにより、ファイアウォール、ロード バランサー、またはサーバー側の非アクティブしきい値によってサイレントに閉じられた可能性のある接続を呼び出し元が受信できないようにします。
値 0 を指定すると、アイドル有効期限が無効になります。接続はプール内に無期限に保持されます ( LoadBalanceTimeout などの他の有効期限ルールに従います)。
アイドル タイムアウトは、 LoadBalanceTimeoutとは無関係に動作します。 どのしきい値を超えた場合でも、最初に接続が破棄されます。