プライマリ・コンテンツに移動

Oracle® Data Provider for .NET開発者ガイド ODAC 12.2c リリース1 (12.2.0.1) for Microsoft Windows E88311-03 |
| 目次 | 索引

前 | 次 |

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

関連項目:

- Oracle.DataAccess.ClientおよびOracle.ManagedDataAccess.Clientのネームスペース

- OracleCommandクラス

- OracleCommandメンバー