ExecuteScalar-Methode
Führt die Abfrage aus und gibt die erste Spalte der ersten Zeile im Resultset zurück, das durch die Abfrage zurückgegeben wird. Zusätzliche Spalten oder Zeilen werden ignoriert.
Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)
Syntax
'Declaration
Public Overrides Function ExecuteScalar As Object
'Usage
Dim instance As SqlCeCommand
Dim returnValue As Object
returnValue = instance.ExecuteScalar()
public override Object ExecuteScalar()
public:
virtual Object^ ExecuteScalar() override
abstract ExecuteScalar : unit -> Object
override ExecuteScalar : unit -> Object
public override function ExecuteScalar() : Object
Rückgabewert
Typ: System. . :: . .Object
Die erste Spalte der ersten Zeile im Resultset.
Implementiert
IDbCommand. . :: . .ExecuteScalar() () () ()
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| InvalidOperationException | Ein Befehl in einem Transaktionskontext, der von dem Kontext abweicht, in dem die Verbindung ursprünglich eingetragen wurde, kann nicht ausführt werden. |
Hinweise
Mit der ExecuteScalar-Methode können Sie einen einzelnen Wert (z. B. einen Aggregatwert) aus einer Datenquelle abrufen. Dafür ist weniger Code erforderlich, als wenn Sie die ExecuteReader-Methode verwenden und anschließend die Operationen ausführen, die für das Generieren eines einzelnen Werts mit den durch eine SqlCeDataReader-Klasse zurückgegebenen Daten erforderlich sind.
Beispiele
Im folgenden Beispiel wird eine SqlCeCommand-Klasse erstellt, und diese wird anschließend mit der ExecuteScalar-Methode ausgeführt. Im Beispiel wird eine Zeichenfolge übergeben, die eine SQL-Anweisung ist, die ein Aggregatergebnis zurückgibt. Außerdem wird eine Zeichenfolge übergeben, mit der die Verbindung mit der Datenquelle hergestellt wird.
Dim cmd As New SqlCeCommand("SELECT col1 FROM myTable", conn)
cmd.Connection.Open()
Dim value As Object = cmd.ExecuteScalar()
conn.Close()
SqlCeCommand cmd = new SqlCeCommand("SELECT col1 FROM myTable", conn);
cmd.Connection.Open();
object value = cmd.ExecuteScalar();
conn.Close();