SqlConnectionStringBuilder.ConnectTimeout 屬性

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v5.2.0

取得或設定在終止嘗試並產生錯誤之前，要等待伺服器連接的時間長度 (以秒為單位)。

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

public int ConnectTimeout { get; set; }

member this.ConnectTimeout : int with get, set

Public Property ConnectTimeout As Integer

屬性值

Int32

ConnectTimeout 屬性的值，如果未提供任何值，則為 15 秒。

範例

下列範例會先顯示未指定 "Connect Timeout" 值的連接字串內容、設定 ConnectTimeout 屬性，然後顯示新的連接字串。

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Server=(local);Initial Catalog=AdventureWorks;" +
                "Integrated Security=true";
            SqlConnectionStringBuilder builder =
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Original: " + builder.ConnectionString);
            Console.WriteLine("ConnectTimeout={0}",
                builder.ConnectTimeout);
            builder.ConnectTimeout = 100;
            Console.WriteLine("Modified: " + builder.ConnectionString);

            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();

        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}

備註

此屬性會對應至連接字串內的 "Connect Timeout"、"connection timeout" 和 "timeout" 索引鍵。

開啟與Azure SQL資料庫的連線時，請將連線逾時設定為 30 秒。

有效值大於或等於 0，且小於或等於2147483647。