SqlCommand.ExecuteScalar 方法

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