OdbcCommand.ExecuteNonQuery メソッド

定義

Connection に対して SQL ステートメントを実行し、影響を受けた行数を返します。

public:
 override int ExecuteNonQuery();
public:
 virtual int ExecuteNonQuery();
public override int ExecuteNonQuery ();
public int ExecuteNonQuery ();
override this.ExecuteNonQuery : unit -> int
abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
Public Overrides Function ExecuteNonQuery () As Integer
Public Function ExecuteNonQuery () As Integer

戻り値

UPDATE、INSERT、DELETE の各ステートメントで、戻り値はそのコマンドの影響を受ける行の数です。 その他のすべての種類のステートメントでは、戻り値は -1 です。

実装

例外

接続が存在しません。

または

接続が開かれていません。

注釈

を使用 ExecuteNonQuery すると、カタログ操作 (データベースの構造の照会やテーブルなどのデータベース オブジェクトの作成など) を実行したり、UPDATE、INSERT、または DELETE ステートメントを実行して、 を使用 DataSetせずにデータベース内のデータを変更したりできます。

基になる ODBC ドライバーでこの機能がサポートされている場合は、 を使用 ExecuteNonQuery して複数の SQL ステートメントを実行することもできます。 この場合、戻り値は コマンド内のすべてのステートメントの影響を受ける行数です。

行は返されませんが ExecuteNonQuery 、パラメーターにマップされた出力パラメーターまたは戻り値にはデータが設定されます。

UPDATE、INSERT、DELETE の各ステートメントで、戻り値はそのコマンドの影響を受ける行の数です。 その他のすべての種類のステートメントでは、戻り値は -1 です。 ロールバックが発生した場合、戻り値も -1 になります。

テーブルにトリガーが存在し、データがテーブルに追加または変更されている場合、戻り値には、挿入操作または更新操作の両方の影響を受ける行数と、トリガーまたはトリガーの影響を受ける行数が含まれます。

適用対象

こちらもご覧ください