SqlConnection.ConnectionTimeout 屬性

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v5.2.0

取得在終止嘗試並產生錯誤前嘗試建立連接的等待時間。

public:
 virtual property int ConnectionTimeout { int get(); };

public override int ConnectionTimeout { get; }

member this.ConnectionTimeout : int

Public Overrides ReadOnly Property ConnectionTimeout As Integer

屬性值

Int32

等待連接開啟的時間 (以秒為單位)。 預設值為 15 秒。

例外狀況

ArgumentException

設定的值小於 0。

範例

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

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    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";
    }
}

備註

您可以使用連接字串中的 或 Connection Timeout 關鍵字，設定連接等候 Connect Timeout 逾時的時間量。 值為 0 表示沒有限制，因此應該避免在 ConnectionString 中，因為嘗試連接會無限期等候。