SqlCommand.ExecuteScalar 方法

最新推荐文章于 2023-12-11 13:15:34 发布

转载最新推荐文章于 2023-12-11 13:15:34 发布 · 210 阅读

0 ·

CC 4.0 BY-SA版权

原文链接：http://www.cnblogs.com/zxlin25/archive/2009/02/26/1399005.html

文章标签：

#c# #数据库

本文介绍了 SqlCommand.ExecuteScalar 方法的用法，该方法用于执行 SQL 查询并返回结果集中第一行的第一列。文章通过示例展示了如何使用 ExecuteScalar 方法来检索单一值，如聚合值，以及如何在 C# 中插入新记录后获取其标识值。

SqlCommand.ExecuteScalar 方法

行查询，并返回查询所返回的结果集中第一行的第一列。忽略其他列或行。

命名空间:System.Data.SqlClient
程序集:System.Data（在 system.data.dll 中）

语法

public override Object ExecuteScalar ()

返回值

结果集中第一行的第一列或空引用（如果结果集为空）。

异常

异常类型	条件
SqlException	在对锁定的行执行该命令期间发生了异常。如果使用的是 Microsoft .NET Framework 1.0 版，将不会生成该异常。

备注

使用 ExecuteScalar 方法从数据库中检索单个值（例如一个聚合值）。与使用 ExecuteReader 方法，然后使用 SqlDataReader 返回的数据执行生成单个值所需的操作相比，此操作需要的代码较少。

典型的 ExecuteScalar 查询可以采用类似于下面的 C# 示例的格式：

复制代码

 cmd.CommandText = "SELECT COUNT(*) FROM dbo.region";
Int32 count = (Int32) cmd.ExecuteScalar();

示例

下面的示例创建一个 SqlCommand，然后使用 ExecuteScalar 执行它。向该示例传递两个字符串，一个字符串表示要插入到表中的新值，另一个字符串用于连接至数据源。如果已插入新行，则此函数会返回新的“Identity”列值，如果失败，则返回 0。

复制代码

static public int AddProductCategory(string newName, string connString)
{
Int32 newProdID = 0;
string sql =
"INSERT INTO Production.ProductCategory (Name) VALUES (@Name); "
+ "SELECT CAST(scope_identity() AS int)";
using (SqlConnection conn = new SqlConnection(connString))
{
SqlCommand cmd = new SqlCommand(sql, conn);
cmd.Parameters.Add("@Name", SqlDbType.VarChar);
cmd.Parameters["@name"].Value = newName;
try
{
conn.Open();
newProdID = (Int32)cmd.ExecuteScalar();
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
}
return (int)newProdID;