IDbCommand.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
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Function ExecuteScalar As Object
'Usage
Dim instance As IDbCommand
Dim returnValue As Object

returnValue = instance.ExecuteScalar

Object ExecuteScalar ()

Object^ ExecuteScalar ()

Object ExecuteScalar ()

function ExecuteScalar () : Object

Rückgabewert

Die erste Spalte der ersten Zeile im Resultset.

Hinweise

Mit der ExecuteScalar-Methode können Sie einen einzelnen Wert (z. B. einen Aggregatwert) aus einer Datenbank 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 des einzelnen Werts mithilfe der durch einen IDataReader zurückgegebenen Daten erforderlich sind.

Eine übliche ExecuteScalar-Abfrage kann wie im folgenden C#-Beispiel formatiert werden:

 CommandText = "select count(*) as NumberOfRegions from region";
 Int32 count = (int) ExecuteScalar();

Beispiel

Im folgenden Beispiel wird eine Instanz der abgeleiteten Klasse SqlCommand erstellt und danach mithilfe von ExecuteScalar ausgeführt. Im Beispiel wird eine Transact-SQL-Anweisung, die ein Aggregatergebnis zurückgibt, als Zeichenfolge sowie eine Zeichenfolge zum Herstellen der Verbindung mit der Datenquelle übergeben.

Public Sub CreateSqlCommand( _
    queryString As String, connection As SqlConnection)

    Dim command As New SqlCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

public void CreateSqlCommand(
    string queryString, SqlConnection connection) 
{
    SqlCommand command = new 
        SqlCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

IDbCommand-Schnittstelle
IDbCommand-Member
System.Data-Namespace