DbCommand.ExecuteScalar Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Executa o comando e devolve a primeira coluna da primeira linha do primeiro conjunto de resultados devolvido. Todas as outras colunas, linhas e conjuntos de resultados são ignorados.
public:
abstract System::Object ^ ExecuteScalar();public abstract object ExecuteScalar();abstract member ExecuteScalar : unit -> objPublic MustOverride Function ExecuteScalar () As ObjectDevoluções
A primeira coluna da primeira linha do primeiro conjunto de resultados.
Implementações
Observações
Use o ExecuteScalar método para recuperar um único valor (por exemplo, um valor agregado) de uma base de dados. Isto requer menos código do que usar o ExecuteReader método e realizar as operações necessárias para gerar o valor único usando os dados devolvidos por um DbDataReader.
Se a primeira coluna da primeira linha do conjunto de resultados não for encontrada, é devolvida uma referência nula (Nothing em Visual Basic). Se o valor na base de dados for null, a consulta devolve DBNull.Value.