從資料庫取得單一值 (ADO.NET)

或許您需要以單一數值傳回資料庫資訊，而非以資料表或資料流的形式。 例如，您或許要傳回彙總函式 (例如 COUNT(*)、SUM(Price) 或 AVG(Quantity)) 的結果。 Command 物件可讓您以 ExecuteScalar 方法傳回單一數值。 ExecuteScalar 方法會將結果集第一個資料列之第一資料行的值當做純量值傳回。

下列程式碼範例會使用 SqlCommand，在資料庫中插入新的值。 ExecuteScalar 方法是用來傳回所插入資料錄的識別資料行值。

Public Function AddProductCategory( _
  ByVal newName As String, ByVal connString As String) As Integer
    Dim newProdID As Int32 = 0
    Dim sql As String = _
     "INSERT INTO Production.ProductCategory (Name) VALUES (@Name); " _
       & "SELECT CAST(scope_identity() AS int);"

    Using conn As New SqlConnection(connString)
        Dim cmd As New SqlCommand(sql, conn)
        cmd.Parameters.Add("@Name", SqlDbType.VarChar)
        cmd.Parameters("@Name").Value = newName
        Try
            conn.Open()
            newProdID = Convert.ToInt32(cmd.ExecuteScalar())
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
    End Using

    Return newProdID
End Function

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

請參閱

概念

執行命令 (ADO.NET)

DbConnection、DbCommand 和 DbException (ADO.NET)

其他資源

命令和參數 (ADO.NET)