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();
  }
}