Sprache

SqlConnectionStringBuilder.IdleTimeout Eigenschaft

Definition

Ruft ab oder legt die maximale Zeit in Sekunden, dass eine Verbindung nicht verwendet (im Leerlauf) im Verbindungspool sitzen kann, bevor sie verworfen wird. Der Standardwert ist 300 (5 Minuten).

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

Eigenschaftswert

Das Leerlauftimeout für poolierte Verbindungen in Sekunden.

Hinweise

Diese Eigenschaft entspricht dem Schlüssel "Verbindungs-Leerlauftimeout" innerhalb der Verbindungszeichenfolge.

In Versionen, in denen der AppContext-Switch Switch.Microsoft.Data.SqlClient.UseLegacyIdleTimeoutBehavior aktiviert ist (Standardeinstellung), behält der Treiber das Verhalten des historischen Poolings bei und erzwingt diese Einstellung nicht. Legen Sie die Option fest, um false die Erzwingung von Leerlaufzeiten zu aktivieren.

Der Treiber bemüht sich am besten, Verbindungen zu verwerfen, die länger als dieser Wert im Leerlauf im Pool verblieben sind. Der genaue Punkt im Verbindungslebenszyklus, an dem die Überprüfung erfolgt, ist ein Implementierungsdetails und kann sich im Laufe der Zeit ändern. Dadurch werden Anrufer vor dem Empfang von Verbindungen geschützt, die möglicherweise von Firewalls, Lastenausgleichs- oder serverseitigen Inaktivitätsschwellenwerten geschlossen wurden.

Ein Wert von Null (0) deaktiviert den Leerlaufablauf; Verbindungen werden unbegrenzt im Pool aufbewahrt (vorbehaltlich anderer Ablaufregeln, z LoadBalanceTimeout. B. ).

Leerlauftimeout wird unabhängig von LoadBalanceTimeout. Je nachdem, welcher Schwellenwert überschritten wird, führt dazu, dass die Verbindung verworfen wird.

Gilt für: