SqlCommand.ExecuteScalar 方法

SqlCommand.ExecuteScalar 方法

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

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

 语法

C#

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。

C#

复制代码

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;