SqlCommand クラス

.NET Framework クラス ライブラリ リファレンス

SqlCommand クラス

SQL Server データベースに対して実行する Transact-SQL ステートメントまたはストアド プロシージャを表します。このクラスは継承できません。

名前空間: System.Data.SqlClient
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 SqlCommand
    Inherits DbCommand
    Implements ICloneable

Visual Basic (使用法)

Dim instance As SqlCommand

C#

public sealed class SqlCommand : DbCommand,
 ICloneable

C++

public ref class SqlCommand sealed : public
 DbCommand, ICloneable

J#

public final class SqlCommand extends DbCommand
 implements ICloneable

JScript

public final class SqlCommand extends
 DbCommand implements ICloneable

解説

SqlCommand のインスタンスを作成すると、読み書き可能なプロパティが初期値に設定されます。これらの初期値の一覧については、SqlCommand コンストラクタのトピックを参照してください。

SqlCommand には、SQL Server データベースでコマンドを実行するための、次のメソッドがあります。

項目	説明
BeginExecuteNonQuery	この SqlCommand によって定義された Transact-SQL ステートメントまたはストアド プロシージャの非同期実行を開始します。通常、INSERT、DELETE、UPDATE、SET ステートメントなどのコマンドが実行されます。BeginExecuteNonQuery は必ず EndExecuteNonQuery とペアで呼び出し、通常はスレッドごとに、操作を完了させる必要があります。
BeginExecuteReader	この SqlCommand によって定義された Transact-SQL ステートメントまたはストアド プロシージャの非同期実行を開始し、サーバーから 1 つまたは複数の結果を取得します。BeginExecuteReader は必ず EndExecuteReader とペアで呼び出し、通常はスレッドごとに、操作を完了させる必要があります。
BeginExecuteXmlReader	この SqlCommand によって定義された Transact-SQL ステートメントまたはストアド プロシージャの非同期実行を開始します。BeginExecuteXmlReader は EndExecuteXmlReader とペアで呼び出す必要があります。これによって、通常はスレッドごとに操作を完了し、XmlReader オブジェクトを取得できます。
ExecuteReader	行を返すコマンドを実行します。パフォーマンスを高めるために、ExecuteReader は Transact-SQL sp_executesql システム ストアド プロシージャを使用してコマンドを呼び出します。そのため、Transact-SQL SET ステートメントなどのコマンドの実行に ExecuteReader を使用すると、期待した効果が得られないことがあります。
ExecuteNonQuery	Transact-SQL の INSERT、DELELE、UPDATE、SET の各ステートメントなどのコマンドを実行します。
ExecuteScalar	データベースから単一の値 (集計値など) を取得します。
ExecuteXmlReader	CommandText を Connection に送信し、XmlReader オブジェクトを構築します。

CommandText プロパティをリセットして、SqlCommand オブジェクトを再利用できます。ただし、新規コマンドまたは以前のコマンドを実行する前に、SqlDataReader を閉じる必要があります。

SqlCommand を実行するメソッドが SqlException を生成した場合、重大度レベルが 19 以下のときは、SqlConnection は開いたままになります。重大度レベルが 20 以上のときは、通常、サーバーは SqlConnection を閉じます。ただし、ユーザーは接続を再び開いて、処理を継続できます。

Topic	Location
チュートリアル : TreeView コントロールでの階層データの表示	Visual Studio での ASP .NET Web アプリケーションの作成

使用例

SqlConnection、SqlCommand、および SqlDataReader を作成する例を次に示します。この例では、データを読み取り、コンソールに出力します。最後に、この例では SqlDataReader を閉じてから、SqlConnection を閉じます。

Visual Basic

Public Sub ReadOrderData(ByVal
 connectionString As String)
    Dim queryString As String
 = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"
    Using connection As New SqlConnection(connectionString)
        Dim command As New
 SqlCommand(queryString, connection)
        connection.Open()
        Dim reader As SqlDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(String.Format("{0},
 {1}", _
                    reader(0), reader(1)))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

C#

private static void ReadOrderData(string
 connectionString)
{
    string queryString = 
        "SELECT OrderID, CustomerID FROM dbo.Orders;";
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(
            queryString, connection);
        connection.Open();
        SqlDataReader reader = command.ExecuteReader();
        try
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}, {1}",
                    reader[0], reader[1]));
            }
        }
        finally
        {
            // Always call Close when done reading.
            reader.Close();
        }
    }
}

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbCommand
        System.Data.SqlClient.SqlCommand

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlCommand メンバ
System.Data.SqlClient 名前空間
その他の技術情報
ADO.NET でのデータへの接続およびデータの取得
.NET Framework Data Provider for SQL Server の使用