共用方式為

SqlConnection.ConnectionTimeout 屬性

定義

命名空間:
System.Data.SqlClient
組件:
System.Data.SqlClient.dll
組件:
System.Data.dll
來源:
System.Data.SqlClient.notsupported.cs

在嘗試建立連線時，會獲得等待時間（以幾秒計），然後才終止嘗試並產生錯誤。

public:
 virtual property int ConnectionTimeout { int get(); };
public:
 property int ConnectionTimeout { int get(); };
public override int ConnectionTimeout { get; }
[System.Data.DataSysDescription("SqlConnection_ConnectionTimeout")]
public int ConnectionTimeout { get; }
member this.ConnectionTimeout : int
[<System.Data.DataSysDescription("SqlConnection_ConnectionTimeout")>]
member this.ConnectionTimeout : int
Public Overrides ReadOnly Property ConnectionTimeout As Integer
Public ReadOnly Property ConnectionTimeout As Integer

屬性值

Int32

等待連線開啟的時間（以秒計）。 預設值為 15 秒。

實作

ConnectionTimeout
屬性
DataSysDescriptionAttribute

例外狀況

ArgumentException

值集合小於 0。

範例

以下範例建立 ， SqlConnection 並將連接 Connection Timeout 串中的 30 秒設定為 。 程式碼會開啟連線，並在主控台視窗中顯示該 ConnectionTimeout 屬性。

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

備註

你可以透過連接 Connect Timeout 字串中的關鍵字 Connection Timeout 來設定連線等待逾時的時間。 值為 0 表示沒有限制，應避免在 中 ConnectionString ，因為嘗試連線會無限期等待。

適用於

另請參閱