DbCommand.ExecuteScalar DbCommand.ExecuteScalar DbCommand.ExecuteScalar DbCommand.ExecuteScalar Method

Definition

Führt die Abfrage aus und gibt die erste Spalte der ersten Zeile im Resultset zurück, das durch die Abfrage zurückgegeben wird.Executes the query and returns the first column of the first row in the result set returned by the query. Alle anderen Spalten und Zeilen werden ignoriert.All other columns and rows are ignored.

public:
 abstract System::Object ^ ExecuteScalar();
public abstract object ExecuteScalar ();
abstract member ExecuteScalar : unit -> obj
Public MustOverride Function ExecuteScalar () As Object

Gibt zurück

Die erste Spalte der ersten Zeile im Resultset.The first column of the first row in the result set.

Implementiert

Hinweise

Verwenden der ExecuteScalar Methode, um einen einzelnen Wert (z. B. einen Aggregatwert) aus einer Datenbank abzurufen.Use the ExecuteScalar method to retrieve a single value (for example, an aggregate value) from a database. Dies erfordert weniger Code als die Verwendung der ExecuteReader -Methode und die Ausführung der Vorgänge, die zum Generieren des einzelnen Werts mithilfe von zurückgegebenen Daten ein 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.

Wenn die erste Spalte der ersten Zeile im Resultset nicht gefunden wird, wird einen null-Verweis (Nothing in Visual Basic) zurückgegeben.If the first column of the first row in the result set is not found, a null reference (Nothing in Visual Basic) is returned. Wenn der Wert in der Datenbank ist null, die Abfrage gibt DBNull.Value.If the value in the database is null, the query returns DBNull.Value.

Gilt für:

Siehe auch