OracleCommand.ExecuteScalar-Methode
Führt die Abfrage aus und gibt die erste Spalte der ersten Zeile im Resultset zurück, das durch die Abfrage als .NET Framework-Datentyp zurückgegeben wird. Zusätzliche Spalten oder Zeilen werden ignoriert.
Namespace: System.Data.OracleClient
Assembly: System.Data.OracleClient (in system.data.oracleclient.dll)
Syntax
'Declaration
Public Overrides Function ExecuteScalar As Object
'Usage
Dim instance As OracleCommand
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 als .NET Framework-Datentyp oder ein NULL-Verweis, wenn das Resultset leer oder ein REF CURSOR ist.
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 erforderlichen Operationen ausführen, um den einzelnen Wert aus den von einem OracleDataReader zurückgegebenen Daten zu generieren.
Eine übliche 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 OracleCommand 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 Datenbank.
Public Sub CreateOracleCommand(myScalarQuery As String, connection As OracleConnection)
Dim command As New OracleCommand(myScalarQuery, connection)
command.Connection.Open()
command.ExecuteScalar()
connection.Close()
End Sub 'CreateOracleCommand
public void CreateOracleCommand(string myScalarQuery, OracleConnection connection)
{
OracleCommand command = new OracleCommand(myScalarQuery, 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
Siehe auch
Referenz
OracleCommand-Klasse
OracleCommand-Member
System.Data.OracleClient-Namespace