SqlCommand イベント

名前 | 説明 | |
---|---|---|
![]() | Disposed | コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。 ( Component から継承されます。) |
![]() | StatementCompleted | Transact-SQL ステートメントの実行が完了すると発生します。 |

関連項目
SqlCommand クラスSystem.Data.SqlClient 名前空間
その他の技術情報
ADO.NET でのデータへの接続およびデータの取得.NET Framework Data Provider for SQL Server の使用
SqlCommand クラス
アセンブリ: System.Data (system.data.dll 内)


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 を閉じます。
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
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.MarshalByRefObject
System.ComponentModel.Component
System.Data.Common.DbCommand
System.Data.SqlClient.SqlCommand


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


SqlCommand コンストラクタ ()
アセンブリ: System.Data (system.data.dll 内)




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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


SqlCommand コンストラクタ (String, SqlConnection, SqlTransaction)
アセンブリ: System.Data (system.data.dll 内)

Public Sub New ( _ cmdText As String, _ connection As SqlConnection, _ transaction As SqlTransaction _ )
Dim cmdText As String Dim connection As SqlConnection Dim transaction As SqlTransaction Dim instance As New SqlCommand(cmdText, connection, transaction)
public SqlCommand ( string cmdText, SqlConnection connection, SqlTransaction transaction )
public: SqlCommand ( String^ cmdText, SqlConnection^ connection, SqlTransaction^ transaction )
public SqlCommand ( String cmdText, SqlConnection connection, SqlTransaction transaction )
public function SqlCommand ( cmdText : String, connection : SqlConnection, transaction : SqlTransaction )
- connection
SQL Server のインスタンスへの接続を表す SqlConnection。

SqlCommand のインスタンスの初期プロパティ値を次の表に示します。
CommandText | cmdText |
CommandTimeout | |
CommandType | CommandType.Text |
connection パラメータの値である新しい SqlConnection。 |

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


SqlCommand コンストラクタ (String, SqlConnection)
アセンブリ: System.Data (system.data.dll 内)

Public Sub New ( _ cmdText As String, _ connection As SqlConnection _ )
Dim cmdText As String Dim connection As SqlConnection Dim instance As New SqlCommand(cmdText, connection)
public SqlCommand ( string cmdText, SqlConnection connection )
public: SqlCommand ( String^ cmdText, SqlConnection^ connection )
public SqlCommand ( String cmdText, SqlConnection connection )
public function SqlCommand ( cmdText : String, connection : SqlConnection )
- connection
SQL Server のインスタンスへの接続を表す SqlConnection。

SqlCommand のインスタンスの初期プロパティ値を次の表に示します。
CommandText | cmdText |
CommandTimeout | |
CommandType | CommandType.Text |
connection パラメータの値である新しい SqlConnection。 |

SqlCommand を作成し、そのプロパティの一部を設定する例を次に示します。
Public Sub CreateCommand(ByVal queryString As String, _ ByVal connectionString As String) Using connection As New SqlConnection(connectionString) Dim command As New SqlCommand(queryString, connection) connection.Open() Dim reader As SqlDataReader = command.ExecuteReader() While reader.Read() Console.WriteLine(String.Format("{0}, {1}", _ reader(0), reader(1))) End While End Using End Sub
private static void CreateCommand(string queryString, string connectionString) { using (SqlConnection connection = new SqlConnection( connectionString)) { SqlCommand command = new SqlCommand( queryString, connection); connection.Open(); SqlDataReader reader = command.ExecuteReader(); while (reader.Read()) { Console.WriteLine(String.Format("{0}, {1}", reader[0], reader[1])); } } }

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


SqlCommand コンストラクタ (String)
アセンブリ: System.Data (system.data.dll 内)


SqlCommand のインスタンスを作成すると、次の読み書き可能プロパティが初期値に設定されます。
CommandText | cmdText |
CommandTimeout | |
CommandType | CommandType.Text |


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


SqlCommand コンストラクタ

名前 | 説明 |
---|---|
SqlCommand () | SqlCommand クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。 |
SqlCommand (String) | クエリ テキストを指定して、SqlCommand クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。 |
SqlCommand (String, SqlConnection) | クエリ テキストと SqlConnection を指定して、SqlCommand クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。 |
SqlCommand (String, SqlConnection, SqlTransaction) | クエリ テキスト、SqlConnection、および SqlTransaction を指定して、SqlCommand クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。 |

SqlCommand プロパティ

名前 | 説明 | |
---|---|---|
![]() | CommandText | オーバーライドされます。 データ ソースで実行する Transact-SQL ステートメントまたはストアド プロシージャを取得または設定します。 |
![]() | CommandTimeout | オーバーライドされます。 コマンドを実行する試みを終了してエラーが生成されるまでの待機時間を取得または設定します。 |
![]() | CommandType | オーバーライドされます。 CommandText プロパティの解釈方法を示す値を取得または設定します。 |
![]() ![]() | Container | Component を格納している IContainer を取得します。 ( Component から継承されます。) |
![]() | DesignTimeVisible | オーバーライドされます。 コマンド オブジェクトを Windows フォーム デザイナ コントロールに表示する必要があるかどうかを示す値を取得または設定します。 |
![]() | Site | Component の ISite を取得または設定します。 ( Component から継承されます。) |
![]() | UpdatedRowSource | オーバーライドされます。 DbDataAdapter の Update メソッドで使用するときに、コマンドの結果を DataRow に適用する方法を取得または設定します。 |

名前 | 説明 | |
---|---|---|
![]() | CanRaiseEvents | コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 ( Component から継承されます。) |
![]() | DesignMode | Component が現在デザイン モードかどうかを示す値を取得します。 ( Component から継承されます。) |
![]() | Events | Component に結び付けられているイベント ハンドラのリストを取得します。 ( Component から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | System.Data.IDbCommand.Transaction |

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


名前 | 説明 | |
---|---|---|
![]() | Dispose | オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。) |
![]() | Finalize | Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 ( Component から継承されます。) |
![]() | GetService | Component またはその Container で提供されるサービスを表すオブジェクトを返します。 ( Component から継承されます。) |
![]() | MemberwiseClone | オーバーロードされます。 ( MarshalByRefObject から継承されます。) |


関連項目
SqlCommand クラスSystem.Data.SqlClient 名前空間
その他の技術情報
ADO.NET でのデータへの接続およびデータの取得.NET Framework Data Provider for SQL Server の使用
SqlCommand メンバ
SQL Server データベースに対して実行する Transact-SQL ステートメントまたはストアド プロシージャを表します。このクラスは継承できません。
SqlCommand データ型で公開されるメンバを以下の表に示します。


名前 | 説明 | |
---|---|---|
![]() | CommandText | オーバーライドされます。 データ ソースで実行する Transact-SQL ステートメントまたはストアド プロシージャを取得または設定します。 |
![]() | CommandTimeout | オーバーライドされます。 コマンドを実行する試みを終了してエラーが生成されるまでの待機時間を取得または設定します。 |
![]() | CommandType | オーバーライドされます。 CommandText プロパティの解釈方法を示す値を取得または設定します。 |
![]() ![]() | Container | Component を格納している IContainer を取得します。(Component から継承されます。) |
![]() | DesignTimeVisible | オーバーライドされます。 コマンド オブジェクトを Windows フォーム デザイナ コントロールに表示する必要があるかどうかを示す値を取得または設定します。 |
![]() | Site | Component の ISite を取得または設定します。(Component から継承されます。) |
![]() | UpdatedRowSource | オーバーライドされます。 DbDataAdapter の Update メソッドで使用するときに、コマンドの結果を DataRow に適用する方法を取得または設定します。 |

名前 | 説明 | |
---|---|---|
![]() | CanRaiseEvents | コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。(Component から継承されます。) |
![]() | DesignMode | Component が現在デザイン モードかどうかを示す値を取得します。(Component から継承されます。) |
![]() | Events | Component に結び付けられているイベント ハンドラのリストを取得します。(Component から継承されます。) |


名前 | 説明 | |
---|---|---|
![]() | Dispose | オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。) |
![]() | Finalize | Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 (Component から継承されます。) |
![]() | GetService | Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (Component から継承されます。) |
![]() | MemberwiseClone | オーバーロードされます。 ( MarshalByRefObject から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | Disposed | コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。(Component から継承されます。) |
![]() | StatementCompleted | Transact-SQL ステートメントの実行が完了すると発生します。 |


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