DbCommand.ExecuteScalar Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Executa o comando e retorna a primeira coluna da primeira linha no primeiro conjunto de resultados retornado. Todas as outras colunas, linhas e conjuntos de resultados são ignorados.
public:
abstract System::Object ^ ExecuteScalar();public abstract object ExecuteScalar ();public abstract object? ExecuteScalar ();abstract member ExecuteScalar : unit -> objPublic MustOverride Function ExecuteScalar () As ObjectRetornos
A primeira coluna da primeira linha no primeiro conjunto de resultados.
Implementações
Comentários
Use o ExecuteScalar método para recuperar um único valor (por exemplo, um valor agregado) de um banco de dados. Isso requer menos código do que usar o ExecuteReader método e executar as operações necessárias para gerar o valor único usando os dados retornados por um DbDataReader.
Se a primeira coluna da primeira linha no conjunto de resultados não for encontrada, uma referência nula (Nothing no Visual Basic) será retornada. Se o valor no banco de dados for null, a consulta retornará DBNull.Value.
