SqlCeCommand.ExecuteScalar Method
Executa a consulta e retorna a primeira coluna da primeira linha do conjunto de resultados retornado pela consulta. As outras colunas ou linhas são ignoradas.
Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em system.data.sqlserverce.dll)
Sintaxe
'Declaração
Public Overrides Function ExecuteScalar As Object
public override Object ExecuteScalar ()
public:
virtual Object^ ExecuteScalar () override
public Object ExecuteScalar ()
public override function ExecuteScalar () : Object
Valor de retorno
A primeira coluna da primeira linha do conjunto de resultados.
Exceções
Tipo de exceção | Condição |
---|---|
InvalidOperationException | Não é possível executar um comando com um contexto de transação diferente do contexto no qual a conexão foi inscrita originalmente. |
Comentários
Use o método ExecuteScalar para recupera um único valor (como um valor agregado) de uma fonte de dados. Isso exige menos código que o uso do método ExecuteReader e a execução das operações necessárias para gerar o único valor usando os dados retornados por um SqlCeDataReader.
Exemplo
O exemplo a seguir cria um SqlCeCommand e o executa usando ExecuteScalar. É passada uma cadeia de caracteres que é uma instrução SQL, que retorna um resultado agregado e uma cadeia de caracteres para conectar a fonte de dados.
Dim cmd As New SqlCeCommand("SELECT col1 FROM myTable", conn)
cmd.Connection.Open()
Dim value As Object = cmd.ExecuteScalar()
conn.Close()
SqlCeCommand cmd = new SqlCeCommand("SELECT col1 FROM myTable", conn);
cmd.Connection.Open();
object value = cmd.ExecuteScalar();
conn.Close();
Segurança de thread
Quaisquer membros estáticos públicos (compartilhados no Microsoft Visual Basic) desse tipo são thread safe. Não há garantia de que qualquer membro de instância seja thread safe.
Plataformas
Plataformas de desenvolvimento
Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informações de versão
.NET Framework e NET Compact Framework
Com suporte no 3.5
.NET Framework
Com suporte no 3.0
.NET Compact Framework e .Net Framework
Com suporte no 2.0
Consulte também
Referência
SqlCeCommand Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace