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

Syntax

'Declaration
Public Overrides Function ExecuteScalar As Object
'Usage
Dim instance As OleDbCommand
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 oder ein NULL-Verweis, wenn das Resultset leer ist.

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 würden, die für das Generieren des einzelnen Werts mithilfe der durch einen OleDbDataReader zurückgegebenen Daten erforderlich sind.

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

CommandText = "SELECT COUNT(*) FROM region";
Int32 count = (int32) ExecuteScalar();

Beispiel

Im folgenden Beispiel wird ein OleDbCommand erstellt und anschließend mit ExecuteScalar ausgeführt. Im Beispiel wird eine SQL-Anweisung als Zeichenfolge übergeben, die ein Aggregatergebnis zurückgibt, sowie eine Zeichenfolge zum Herstellen der Verbindung mit der Datenquelle.

Public Sub CreateMyOleDbCommand(queryString As String, _
    connection As OleDbConnection)
    Dim command As New OleDbCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub 

public void CreateMyOleDbCommand(string queryString, 
    OleDbConnection connection) 
{
    OleDbCommand command = new OleDbCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

Siehe auch

Referenz

OleDbCommand-Klasse
OleDbCommand-Member
System.Data.OleDb-Namespace

Weitere Ressourcen

Arbeiten mit Befehlen