6.2.5.9 ExecuteScalar
このメソッドでは、接続を使用して問合せを実行し、問合せによって戻された結果セット内の最初の行の最初の列を戻します。
宣言
// C# public override object ExecuteScalar();
戻り値
最初の行、最初の列の値を表すオブジェクト
実装
IDbCommand
例外
InvalidOperationException
- コマンドを実行できない場合
備考
追加列または行は無視されます。ExecuteScalar
では、データベースから単一値(たとえば集合値)を取り出します。ExecuteReader()
メソッドを使用する場合より少ないコードで済み、必要な操作を実行してOracleDataReader
によって戻されたデータで単一値を生成します。
問合せで行を戻さない場合は、null
を戻します。
XmlCommandType
プロパティの値が次のいずれかに設定されている場合、ExecuteScalar
メソッドがInvalidOperationException
をスローします。OracleXmlCommandType
値: Insert
、Update
、Delete
、Query
。
例
// C# using System; using System.Data; using Oracle.DataAccess.Client; class ExecuteScalarSample { static void Main() { string constr = "User Id=scott;Password=tiger;Data Source=oracle"; OracleConnection con = new OracleConnection(constr); con.Open(); OracleCommand cmd = new OracleCommand("select count(*) from emp", con); object count = cmd.ExecuteScalar(); Console.WriteLine("There are {0} rows in table emp", count); // Clean up cmd.Dispose(); con.Dispose(); } }