英語で読む

次の方法で共有


SqlConnection.ConnectionTimeout プロパティ

定義

試行を終了してエラーを生成するまでの、接続の確立の試行時に待機する時間 (秒単位) を取得します。

public override int ConnectionTimeout { get; }
[System.Data.DataSysDescription("SqlConnection_ConnectionTimeout")]
public int ConnectionTimeout { get; }

プロパティ値

接続が開くのを待機する時間 (秒単位)。 既定値は 15 秒です。

実装

属性

例外

0 より小さい値が設定されました。

次の例では、 をSqlConnection作成し、接続文字列で を 30 秒に設定Connection Timeoutします。 コードによって接続が開き、 プロパティが ConnectionTimeout コンソール ウィンドウに表示されます。

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 回避する必要があります。

適用対象

製品 バージョン
.NET Core 1.0, Core 1.1, 6 (package-provided), 7 (package-provided), 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)

こちらもご覧ください