DbCommand.ExecuteScalar Método

Definição

Quando substituído em uma classe derivada, executa a consulta e retorna a primeira coluna da primeira linha no conjunto de resultados retornado pela consulta.When overridden in a derived class, executes the query and returns the first column of the first row in the result set returned by the query. Todas as outras colunas e linhas são ignoradas.All other columns and rows are ignored.

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

Object

A primeira coluna da primeira linha no conjunto de resultados.The first column of the first row in the result set.

Implementações

Comentários

Use o ExecuteScalar método para recuperar um único valor (por exemplo, um valor de agregação) de um banco de dados.Use the ExecuteScalar method to retrieve a single value (for example, an aggregate value) from a database. 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 .This requires less code than using the ExecuteReader method and performing the operations necessary to generate the single value using the data returned by a DbDataReader.

Se a primeira coluna da primeira linha no conjunto de resultados não for encontrada, uma referência nula ( Nothing em Visual Basic) será retornada.If the first column of the first row in the result set is not found, a null reference (Nothing in Visual Basic) is returned. Se o valor no banco de dados for null , a consulta retornará DBNull.Value .If the value in the database is null, the query returns DBNull.Value.

Aplica-se a