SqlCommand.ExecuteScalar 方法
執(zhí)行查詢,并返回查詢所返回的結(jié)果集中第一行的第一列。忽略其他列或行。
命名空間:System.Data.SqlClient 程序集:System.Data(在 system.data.dll 中)
語法:
public override Object ExecuteScalar ()
返回值:
結(jié)果集中第一行的第一列或空引用(如果結(jié)果集為空)。
異常
異常類型 | 條件 |
SqlException
|
在對鎖定的行執(zhí)行該命令期間發(fā)生了異常。如果使用 的是 Microsoft .NET Framework 1.0 版,將不會生成該異常。
|
備注
使用 ExecuteScalar 方法從數(shù)據(jù)庫中檢索單個值(例如一個聚合值)。與 使用 ExecuteReader 方法,然后使用 SqlDataReader 返回的數(shù)據(jù)執(zhí)行生
成單個值所需的操作相比,此操作需要的代碼較少。
典型的 ExecuteScalar 查詢可以采用類似于下面的 C# 示例的格式:
cmd.CommandText = "SELECT COUNT(*) FROM dbo.region";
Int32 count = (Int32) cmd.ExecuteScalar();
示例
下面的示例創(chuàng)建一個 SqlCommand,然后使用 ExecuteScalar 執(zhí)行它。 向該示例傳遞兩個字符串,一個字符串表示要插入到表中的新值,另一個字
符串用于連接至數(shù)據(jù)源。如果已插入新行,則此函數(shù)會返回新的“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;
}
|