OracleCommand.ExecuteScalar Methode

  • Referenz

Definition

Namespace:
System.Data.OracleClient
Assembly:
System.Data.OracleClient.dll

Führt die Abfrage aus und gibt die erste Spalte der ersten Zeile im Resultset zurück, das durch die Abfrage als .NET-Datentyp zurückgegeben wird. Zusätzliche Spalten oder Zeilen werden ignoriert.

public:
 virtual System::Object ^ ExecuteScalar();
public:
 override System::Object ^ ExecuteScalar();
public object ExecuteScalar ();
public override object ExecuteScalar ();
abstract member ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
Public Function ExecuteScalar () As Object
Public Overrides Function ExecuteScalar () As Object

Gibt zurück

Object

Die erste Spalte der ersten Zeile im Resultset als .NET-Datentyp oder ein NULL-Verweis, wenn das Resultset leer oder ein REF CURSOR ist.

Implementiert

ExecuteScalar()

Beispiele

Im folgenden Beispiel wird ein OracleCommand erstellt und dann mit ExecuteScalarausgeführt. Im Beispiel wird eine Zeichenfolge übergeben, bei der es sich um eine SQL-Anweisung handelt, die ein Aggregatergebnis zurückgibt, und eine Zeichenfolge, die zum Herstellen einer Verbindung mit der Datenbank verwendet werden soll.

public void CreateOracleCommand(string myScalarQuery, OracleConnection connection)
 {
    OracleCommand command = new OracleCommand(myScalarQuery, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
 }

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

Hinweise

Verwenden Sie die ExecuteScalar -Methode, um einen einzelnen Wert (z. B. einen Aggregatwert) aus einer Datenbank abzurufen. Dies erfordert weniger Code als die Verwendung der ExecuteReader -Methode und dann das Ausführen der Vorgänge, die erforderlich sind, um den einzelnen Wert aus den von einem OracleDataReaderzurückgegebenen Daten zu generieren.

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

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

Gilt für:

Weitere Informationen