SqlCeCommand.ExecuteNonQuery メソッド

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

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)

構文

'宣言
Public Overrides Function ExecuteNonQuery As Integer
'使用
Dim instance As SqlCeCommand
Dim returnValue As Integer

returnValue = instance.ExecuteNonQuery

public override int ExecuteNonQuery ()

public:
virtual int ExecuteNonQuery () override

public int ExecuteNonQuery ()

public override function ExecuteNonQuery () : int

適用できません。

戻り値

影響を受けた行数。

例外

解説

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

重要 :
ExecuteNonQuery では、カーソルが使用されません。そのため、データベースにロックが設定されません。ロックが必要なコマンドを実行する場合は、ExecuteNonQuery を使用しないでください。代わりに、ExecuteReader を使用します。

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

CREATE TABLE や ALTER TABLE などの DDL ステートメントでの戻り値は、0 です。

メモ :
この動作は、System.Data.SqlClient の動作とは異なります。

使用例

SqlCeCommand を作成し、ExecuteNonQuery を使用して実行する例を次に示します。この例では、SQL ステートメント (UPDATE、INSERT、DELETE など) の文字列と、データ ソースへの接続用の文字列が渡されます。

conn.Open()
Dim cmd As New SqlCeCommand("INSERT INTO foo (col1) VALUES (1)", conn)
cmd.ExecuteNonQuery()
conn.Close()

conn.Open();
SqlCeCommand cmd = new SqlCeCommand("INSERT INTO foo (col1) VALUES (1)", conn);
cmd.ExecuteNonQuery();
conn.Close();

プラットフォーム

Windows 98,Windows Server 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

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

バージョン情報

.NET Framework

サポート対象 : 3.0

.NET Compact Framework

サポート対象 : 2.0,1.0

参照

関連項目

SqlCeCommand クラス
SqlCeCommand メンバ
System.Data.SqlServerCe 名前空間