OracleCommand.ExecuteNonQuery メソッド

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

OracleCommand.ExecuteNonQuery メソッド

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

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

Visual Basic (宣言)

Public Overrides Function
 ExecuteNonQuery As Integer

Visual Basic (使用法)

Dim instance As OracleCommand
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 の各ステートメントでは、戻り値はそのコマンドの影響を受ける行の数です。CREATE TABLE ステートメントおよび DROP TABLE ステートメントでは、戻り値は 0 です。その他の種類のステートメントでは、戻り値は -1 です。

例外

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

解説

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

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

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

使用例

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

Visual Basic

Public Sub CreateOracleCommand(ByVal
 myExecuteQuery As String, _
ByVal connectionString As String)
    Using connection As New OracleConnection(connectionString)
        Dim command As New
 OracleCommand(myExecuteQuery, connection)
        command.Connection.Open()
        command.ExecuteNonQuery()
    End Using
End Sub

C#

public void CreateOracleCommand(string
 myExecuteQuery, string connectionString)
{
    using (OracleConnection connection = new
 OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(myExecuteQuery,
 connection);
        command.Connection.Open();
        command.ExecuteNonQuery();
    }
}

プラットフォーム

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

参照

関連項目
OracleCommand クラス
OracleCommand メンバ
System.Data.OracleClient 名前空間
その他の技術情報
コマンドの使用