SqlCeCommand.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
public Object ExecuteScalar ()
public override function ExecuteScalar () : Object
Rückgabewert
Die erste Spalte der ersten Zeile im Resultset.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
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.
Beispiel
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();
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .
Plattformen
Windows CE, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows XP Professional x64 Edition, Windows XP SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
SqlCeCommand-Klasse
SqlCeCommand-Member
System.Data.SqlServerCe-Namespace