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 Database への接続を開くときは、接続タイムアウトを 30 秒に設定します。

有効な値は 0 以上で、2147483647以下です。