次の方法で共有

SqlCeCommand.ExecuteNonQuery メソッド

  • [アーティクル]

メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。

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

Public Overridable Function ExecuteNonQuery() As Integer Implements _   IDbCommand.ExecuteNonQuery
[C#]
public virtual int ExecuteNonQuery();
[C++]
public: virtual int ExecuteNonQuery();
[JScript]
public function ExecuteNonQuery() : int;

戻り値

影響を受けた行数。

実装

IDbCommand.ExecuteNonQuery

例外

例外の種類 条件
InvalidOperationException 接続が存在しません。

または

接続が開いていません。

または接続を登録した当初のトランザクション コンテキストとは異なるコンテキストでは、コマンドを実行できません。

解説

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

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

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

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

使用例

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

 
Public Sub CreateMySqlCeCommand(myExecuteQuery As String, myConnection As SqlCeConnection)
    Dim myCommand As New SqlCeCommand(myExecuteQuery, myConnection)
    myCommand.Connection.Open()
    myCommand.ExecuteNonQuery()
    myConnection.Close()
End Sub 

[C#] 
public void CreateMySqlCeCommand(string myExecuteQuery, SqlCeConnection myConnection) {
    SqlCeCommand myCommand = new SqlCeCommand(myExecuteQuery, myConnection);
    myCommand.Connection.Open();
    myCommand.ExecuteNonQuery();
    myConnection.Close();
}

[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: .NET Compact Framework - Windows CE .NET

.NET Framework セキュリティ:

参照

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