SqlCommand.ExecuteScalar 方法

SqlCommand.ExecuteScalar 方法

行查詢，並返回查詢所返回的結果集中第一行的第一列。忽略其他列或行。

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

 文法

C#

public override Object ExecuteScalar ()

傳回值

結果集中第一行的第一列或Null 參考（如果結果集為空白）。

 異常

異常類型	條件
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;