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 作成し、接続文字列で を 30 秒に設定 Connection Timeout します。 コードによって接続が開き、コンソール ウィンドウに プロパティが表示されます 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 で回避する必要があります。