SqlConnectionStringBuilder.ConnectTimeout プロパティ

  • リファレンス

定義

名前空間:
System.Data.SqlClient
アセンブリ:
System.Data.SqlClient.dll
アセンブリ:
System.Data.dll
パッケージ:
System.Data.SqlClient v4.8.6

サーバーへの接続を待機する時間の長さ (秒単位) を取得または設定します。この時間が経過すると、接続の試行が終了し、エラーが生成されます。

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 秒に設定します。

適用対象

こちらもご覧ください