SqlConnectionStringBuilder.IdleTimeout 屬性

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v7.1.0

取得或設定連線在連接池中閒置（閒置）的最大時間（秒數），直到被丟棄。 預設值為 300 （5 分鐘）。

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

public int IdleTimeout { get; set; }

member this.IdleTimeout : int with get, set

Public Property IdleTimeout As Integer

屬性值

Int32

共用連線的閒置超時，只需幾秒鐘。

備註

此特性對應於 連接字串 中的「Connection Idle Timeout」鍵。

在啟用 AppContext 開關 Switch.Microsoft.Data.SqlClient.UseLegacyIdleTimeoutBehavior （預設值）的版本中，驅動程式會保留歷史的池化行為，並不會強制執行此設定。 將開關設為 以 false 啟用閒置超時強制執行。

駕駛員會盡力丟棄那些在池中閒置超過此值的連接。 檢查發生的連線生命週期精確點是實作細節，且可能隨時間改變。 這保護呼叫者不會收到可能因防火牆、負載平衡器或伺服器端不活躍閾值而悄然關閉的連線。

值為零（0）則停用閒置過期;連線會無限期保留在池中（受其他到期規則限制，例如 LoadBalanceTimeout）。

閒置超時獨立 LoadBalanceTimeout於 。 先超過的門檻即會丟棄該連線。