DbCommand.ExecuteScalar Methode

Definition

Führt bei Überschreibung in einer abgeleiteten Klasse die Abfrage aus und gibt die erste Spalte der ersten Zeile des Resultsets zurück, das für die Abfrage zurückgegeben wurde.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. 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 Sie die 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 erforderlich sind, um den einzelnen Wert mithilfe der von einem DbDataReaderzurückgegebenen Daten zu generieren.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 ein 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 nullist, gibt die Abfrage DBNull.Valuezurück.If the value in the database is null, the query returns DBNull.Value.

Gilt für:

Siehe auch