Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a: .NET Framework
.NET
.NET Standard
Talvez seja necessário retornar informações de banco de dados que são simplesmente um único valor, em vez de na forma de uma tabela ou fluxo de dados. Por exemplo, talvez você queira retornar o resultado de uma função agregada, como COUNT(*), SUM(Price) ou AVG(Quantity). O objeto Command oferece a capacidade de devolver valores únicos usando o método ExecuteScalar . O método ExecuteScalar devolve, como valor escalar, o valor da primeira coluna da primeira linha do conjunto de resultados.
Example
O exemplo de código a seguir insere um novo valor no banco de dados usando um SqlCommand. O ExecuteScalar método é usado para retornar o valor da coluna de identidade para o registro inserido.
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;
}