OdbcCommand.ExecuteNonQuery メソッド

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

OdbcCommand.ExecuteNonQuery メソッド

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

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

Visual Basic (宣言)

Public Overrides Function
 ExecuteNonQuery As Integer

Visual Basic (使用法)

Dim instance As OdbcCommand
Dim returnValue As Integer

returnValue = instance.ExecuteNonQuery

C#

public override int ExecuteNonQuery ()

C++

public:
virtual int ExecuteNonQuery () override

J#

public int ExecuteNonQuery ()

JScript

public override function ExecuteNonQuery ()
 : int

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

例外

例外の種類	条件
InvalidOperationException	接続が存在しません。 または 接続が開いていません。

解説

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

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

ExecuteNonQuery は行を返しませんが、出力パラメータ、またはパラメータに割り当てられた戻り値には、データが格納されます。

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
OdbcCommand クラス
OdbcCommand メンバ
System.Data.Odbc 名前空間
その他の技術情報
Executing a Command