Método SqlCeCommand.ExecuteScalar
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
'Uso
Dim instance As SqlCeCommand
Dim returnValue As Object
returnValue = instance.ExecuteScalar()
public override Object ExecuteScalar()
public:
virtual Object^ ExecuteScalar() override
abstract ExecuteScalar : unit -> Object
override ExecuteScalar : unit -> Object
public override function ExecuteScalar() : Object
Valor de retorno
Tipo: System.Object
A primeira coluna da primeira linha do conjunto de resultados.
Implementa
Exceções
| 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.
Exemplos
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();