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