使用 ADO.NET 的 ExecuteScalar 方法返回单一值

(本文在版工的旧 Blog 中，发表日期为 2007/03/31)
(本文有些 Hyperlink 是連到台灣的網站，內地的網友可能會無法開啟連結)

若您程序中执行的 SQL statement 或 Stored Procedure，只是要返回计算过的「单一值」，例如:
SELECT Count(*) FROM 员工数据表

或只会回传符合条件的「第一笔」record 的「第一个」column 其值，例如:
SELECT 电子信箱 FROM 员工数据表 WHERE 姓名= 'David'

我们即可用 Command 对象的 ExecuteScalar 方法 (ADO.NET 1.x 即支援。DbCommand 对象则要 .NET 2.0 才支持)，以回传数据集中第一个 row 的第一个 column 其存储值，并忽略其它无用的数据；此种做法比起用ExecuteReader 方法回传「多组」record，再指定给 DataReader 对象，再逐一比对数据，可更有效地节省系统资源并提升「性能 (performance)」。


但由于 ExecuteScalar 方法回传的必为 Object 类型，因此必须由程序员，手动将其强制转型为 .NET 的 int 或 string 等想要的类型，以便直接指派给 int 或 string 类型的变量，或显示在页面上的控件中，如下所示：
string theMail = (string)cmd.ExecuteScalar();

因此使用 ExecuteScalar 方法时，在程序中必须先确定，承接回传值的变量其类型为何，否则会发生转型错误。此外，在上例中，若「员工数据表」内有超过一个以上叫做「David」的员工，则 ExecuteScalar 方法只会回传「第一个」叫做 David 的员工其电子信箱，而忽略其它亦符合条件的数据。

此外，ExecuteScalar 方法不只可以用在数据库的 SELECT 作业，亦可用于 INSERT 作业。假设我们想要在 INSERT 一笔 record 至数据库后，马上取得刚才新增那一笔 record 的 Identity (自动增号) 的值，可用下列 SQL statement 达成：
string strSql = "INSERT INTO 数据表 (name, age) VALUES ('David', 20); Select @@Identity";

此时，我们即可用 ExecuteScalar 方法，取代 ExecuteNonQuery 方法，去执行上述这一段 SQL statement，以便返回一笔计算过的「单一值」，亦即最新的 Identity 流水号码，关键 ADO.NET 代码如下：

SqlConnection conn = new SqlConnection(strConnString);
SqlCommand cmd = new SqlCommand(strSqlStr, conn);

try
{
    conn.Open();
    if (conn.State == ConnectionState.Open)
    {
        // 返回最新的 Identity 流水号码
        intNewestSerialNum = Convert.ToInt32(cmd.ExecuteScalar());
    }

}
catch (SqlException ex)
{