SqlConnection.ConnectionTimeout 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得在終止嘗試並產生錯誤前嘗試建立連接的等待時間 (以秒為單位)。
public:
virtual property int ConnectionTimeout { int get(); };public:
property int ConnectionTimeout { int get(); };C#
public override int ConnectionTimeout { get; }C#
[System.Data.DataSysDescription("SqlConnection_ConnectionTimeout")]
public int ConnectionTimeout { get; }member this.ConnectionTimeout : int[<System.Data.DataSysDescription("SqlConnection_ConnectionTimeout")>]
member this.ConnectionTimeout : intPublic Overrides ReadOnly Property ConnectionTimeout As IntegerPublic ReadOnly Property ConnectionTimeout As Integer等待連接開啟的時間 (以秒為單位)。 預設值為 15 秒。
- 屬性
設定的值小於 0。
下列範例會在 SqlConnection 連接字串 中建立 ，並將 設定Connection Timeout為 30 秒。 程式代碼會開啟連接， ConnectionTimeout 並在主控台視窗中顯示 屬性。
C#
private static void OpenSqlConnection()
{
string connectionString = GetConnectionString();
using (SqlConnection connection = new SqlConnection(connectionString))
{
connection.Open();
Console.WriteLine("State: {0}", connection.State);
Console.WriteLine("ConnectionTimeout: {0}",
connection.ConnectionTimeout);
}
}
static private string GetConnectionString()
{
// To avoid storing the connection string in your code,
// you can retrieve it from a configuration file, using the
// System.Configuration.ConfigurationSettings.AppSettings property
return "Data Source=(local);Initial Catalog=AdventureWorks;"
+ "Integrated Security=SSPI;Connection Timeout=30";
}
Private Sub OpenSqlConnection()
Dim connectionString As String = GetConnectionString()
Using connection As New SqlConnection(connectionString)
connection.Open()
Console.WriteLine("State: {0}", connection.State)
Console.WriteLine("ConnectionTimeout: {0}", connection.ConnectionTimeout)
End Using
End Sub
Private Function GetConnectionString() As String
' To avoid storing the connection string in your code,
' you can retrieve it from a configuration file, using the
' System.Configuration.ConfigurationSettings.AppSettings property
Return "Data Source=(local);Database=AdventureWorks;" _
& "Integrated Security=SSPI;Connection Timeout=30;"
End Function
您可以使用 連接字串 中的 或 Connection Timeout 關鍵詞，設定連線等候Connect Timeout逾時的時間量。 值為 0 表示沒有限制，因此應該避免在 ConnectionString 中，因為嘗試連接會無限期等候。
適用於
| 產品 | 版本 |
|---|---|
| .NET | Core 1.0, Core 1.1, 6 (package-provided), 7 (package-provided), 8 (package-provided), 9 (package-provided), 10 (package-provided) |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0 (package-provided) |
