英語で読む

次の方法で共有


SqlCommand.Connection プロパティ

定義

この SqlCommand のインスタンスで使用する SqlConnection を取得または設定します。

C#
public System.Data.SqlClient.SqlConnection Connection { get; set; }
C#
[System.Data.DataSysDescription("DbCommand_Connection")]
public System.Data.SqlClient.SqlConnection Connection { get; set; }

プロパティ値

データ ソースへの接続。 既定値は null です。

属性

例外

コマンドがトランザクションに登録されていた間に、Connection プロパティが変更されました。

次の例では、 を SqlCommand 作成し、そのプロパティの一部を設定します。

C#
private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand();
        command.Connection = connection;
        command.CommandTimeout = 15;
        command.CommandType = CommandType.Text;
        command.CommandText = queryString;

        connection.Open();
        SqlDataReader reader = command.ExecuteReader();
        while (reader.Read())
        {
            Console.WriteLine(String.Format("{0}, {1}",
                reader[0], reader[1]));
        }
    }
}

注釈

コマンドが既存のトランザクションに参加していて、接続が変更された場合、コマンドを実行しようとすると が InvalidOperationExceptionスローされます。

Transaction プロパティが NULL でない場合、トランザクションが既にコミット済みまたはロールバック済みであれば、Transaction は NULL に設定されます。

適用対象

製品 バージョン
.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)

こちらもご覧ください