IDbCommand.ExecuteNonQuery メソッド

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

IDbCommand.ExecuteNonQuery メソッド

.NET Framework データ プロバイダの Connection オブジェクトに対して SQL ステートメントを実行し、影響を受けた行の数を返します。

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

Visual Basic (宣言)

Function ExecuteNonQuery As Integer

Visual Basic (使用法)

Dim instance As IDbCommand
Dim returnValue As Integer

returnValue = instance.ExecuteNonQuery

C#

int ExecuteNonQuery ()

C++

int ExecuteNonQuery ()

J#

int ExecuteNonQuery ()

JScript

function ExecuteNonQuery () : int

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

例外

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

解説

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

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

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

使用例

派生クラス OleDbCommand のインスタンスを作成し、このインスタンスを実行する例を次に示します。この例では、SQL SELECT ステートメントである文字列と、データ ソースに接続するために使用する文字列をメソッドに渡します。

Visual Basic

Private Sub CreateOleDbCommand( _
    ByVal queryString As String,
 ByVal connectionString As String)
    Using connection As New OleDbConnection(connectionString)
        connection.Open()
        Dim command As New
 OleDbCommand(queryString, connection)
        command.ExecuteNonQuery()
    End Using
End Sub

C#

static private void CreateOleDbCommand(
    string queryString, string connectionString)
{
    using (OleDbConnection connection = new
 
               OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbCommand command = new 
            OleDbCommand(queryString, connection);
        command.ExecuteNonQuery();
    }
}

プラットフォーム

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

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

バージョン情報

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

参照

関連項目
IDbCommand インターフェイス
IDbCommand メンバ
System.Data 名前空間