DbCommand.ExecuteNonQuery メソッド

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

接続オブジェクトに対してコマンドを実行し、影響を受けた行数を返します。

public:
 abstract int ExecuteNonQuery();

public abstract int ExecuteNonQuery ();

abstract member ExecuteNonQuery : unit -> int

Public MustOverride Function ExecuteNonQuery () As Integer

Int32

影響を受けた行の数。

ExecuteNonQuery()

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

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

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

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	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, 2.1
UWP	10.0