Compartilhar via


DbCommand.ExecuteScalar Método

Definição

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 -> obj
Public MustOverride Function ExecuteScalar () As Object

Retornos

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.

Aplica-se a

Confira também