OracleCommand.ExecuteOracleNonQuery メソッド

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

OracleCommand.ExecuteOracleNonQuery メソッド

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

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

Visual Basic (宣言)

Public Function ExecuteOracleNonQuery ( _
    <OutAttribute> ByRef rowid As OracleString
 _
) As Integer

Visual Basic (使用法)

Dim instance As OracleCommand
Dim rowid As OracleString
Dim returnValue As Integer

returnValue = instance.ExecuteOracleNonQuery(rowid)

C#

public int ExecuteOracleNonQuery (
    out OracleString rowid
)

C++

public:
int ExecuteOracleNonQuery (
    [OutAttribute] OracleString% rowid
)

J#

public int ExecuteOracleNonQuery (
    /** @attribute OutAttribute() */ /** @ref */ OracleString rowid
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

rowid

サーバーの実際の行 ID の base64 文字列表現。

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

例外

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

解説

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

ExecuteOracleNonQuery が ExecuteNonQuery と異なるのは、1 行だけに影響する INSERT、DELETE、または UPDATE ステートメントを実行した場合に、出力パラメータとして rowid を返すという点です。この機能により、Oracle データベースで行を一意に識別でき、以降の関連するクエリのパフォーマンスが向上します。

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

プラットフォーム

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 名前空間
その他の技術情報
コマンドの使用