SqlCeCommand.ExecuteNonQuery メソッド

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

SqlCeCommand.ExecuteNonQuery メソッド

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

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

Visual Basic (宣言)

Public Overrides Function
 ExecuteNonQuery As Integer

Visual Basic (使用法)

Dim instance As SqlCeCommand
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

戻り値
影響を受けた行数。

例外

例外の種類	条件
InvalidOperationException	接続が存在しません。 または 接続が開いていません。 または 接続を登録した当初のトランザクション コンテキストとは異なるコンテキストでは、コマンドを実行できません。

解説

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 など) の文字列と、データ ソースへの接続用の文字列が渡されます。

Visual Basic

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

C#

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

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlCeCommand クラス
SqlCeCommand メンバ
System.Data.SqlServerCe 名前空間