SqlCeCommand.ExecuteScalar-Methode

Hinweis: Dieser Namespace oder Member bzw. diese Klasse wird nur von .NET Framework, Version 1.1, unterstützt.

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.

Public Overridable Function ExecuteScalar() As Object Implements _   IDbCommand.ExecuteScalar
[C#]
public virtual object ExecuteScalar();
[C++]
public: virtual Object* ExecuteScalar();
[JScript]
public function ExecuteScalar() : Object;

Rückgabewert

Die erste Spalte der ersten Zeile im Resultset.

Implementiert

IDbCommand.ExecuteScalar

Ausnahmen

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 Wertes mit den durch einen SqlCeDataReader zurückgegebenen Daten erforderlich sind.

Beispiel

[Visual Basic, C#] Im folgenden Beispiel wird ein SqlCeCommand erstellt und dieser anschließend mit ExecuteScalar 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.

 
Public Sub CreateMySqlCeCommand(ByVal myScalarQuery As String, ByVal myConnection As SqlCeConnection)
    Dim myCommand As New SqlCeCommand(myScalarQuery, myConnection)
    myCommand.Connection.Open()
    myCommand.ExecuteScalar()
    myConnection.Close()
End Sub

[C#] 
public void CreateMySqlCeCommand(string myScalarQuery, SqlCeConnection myConnection) {
    SqlCeCommand myCommand = new SqlCeCommand(myScalarQuery, myConnection);
    myCommand.Connection.Open();
    myCommand.ExecuteScalar();
    myConnection.Close();
}

[C++, JScript] Für C++ oder JScript ist kein Beispiel verfügbar. Klicken Sie zum Anzeigen eines Beispiels für Visual Basic oder C# in der linken oberen Ecke der Seite auf die Schaltfläche "Sprachfilter" .

Anforderungen

Plattformen: .NET Compact Framework - Windows CE .NET

.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 Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

SqlCeCommand-Klasse | SqlCeCommand-Member | System.Data.SqlServerCe-Namespace