SqlBatch.ExecuteNonQuery メソッド

定義

重要

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

接続オブジェクトに対してバッチを実行し、すべてのバッチコマンドで影響を受けた行の合計数を返します。

public:
 override int ExecuteNonQuery();

public override int ExecuteNonQuery ();

override this.ExecuteNonQuery : unit -> int

Public Overrides Function ExecuteNonQuery () As Integer

Int32

すべてのバッチコマンドで影響を受ける行の合計数。

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

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

UPDATE、INSERT、および DELETE ステートメントの場合、戻り値はバッチの影響を受ける行の合計数です。バッチに UPDATE、INSERT、または DELETE ステートメントが含まれていない場合、戻り値は -1 になります。

注意

このメソッドはから ExecuteNonQuery()メリットを得て、そのメソッドの予期されるすべての例外もここで適用されます。