SqlConnectionStringBuilder.ConnectTimeout 屬性

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.dll

取得或設定等待連線至伺服器的時間（秒數），然後終止連線並產生錯誤。

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 System.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);
        }
    }
}

Imports System.Data.SqlClient
    
Module Module1

    Sub Main()
        Try
            Dim connectString As String = _
             "Server=(local);Initial Catalog=AdventureWorks;" & _
             "Integrated Security=True"
            Dim builder As 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 ex As Exception
            Console.WriteLine(ex.Message)
        End Try
    End Sub

End Module

備註

此特性對應於連接字串中的「Connect Timeout」、「connection timeout」和「timeout」鍵。

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

另請參閱

• ADO.NET 中的連接字串
• ADO.NET 概觀