DbCommand.ExecuteScalar Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Führt den Befehl aus und gibt die erste Spalte der ersten Zeile im ersten zurückgegebenen Resultset zurück. Alle anderen Spalten, Zeilen und Resultsets werden ignoriert.
public:
abstract System::Object ^ ExecuteScalar();
public abstract 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 ersten Resultset.
Implementiert
Hinweise
Verwenden Sie die ExecuteScalar -Methode, um einen einzelnen Wert (z. B. einen Aggregatwert) aus einer Datenbank abzurufen. Dies erfordert weniger Code als die Verwendung der ExecuteReader -Methode und das Ausführen der Vorgänge, die zum Generieren des einzelnen Werts unter Verwendung der von einem DbDataReaderzurückgegebenen Daten erforderlich sind.
Wenn die erste Spalte der ersten Zeile im Resultset nicht gefunden wird, wird ein NULL-Verweis (Nothing
in Visual Basic) zurückgegeben. Wenn der Wert in der Datenbank ist, gibt null
die Abfrage zurück DBNull.Value
.