OracleCommand.ExecuteScalar Metoda

  • Reference

Definice

Obor názvů:
System.Data.OracleClient
Sestavení:
System.Data.OracleClient.dll

Provede dotaz a vrátí první sloupec prvního řádku v sadě výsledků vrácený dotazem jako datový typ .NET. Nadbytečné sloupce nebo řádky se ignorují.

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

Návraty

Object

První sloupec prvního řádku v sadě výsledků jako datový typ .NET nebo odkaz null, pokud je sada výsledků prázdná nebo výsledkem je REF CURSOR.

Implementuje

ExecuteScalar()

Příklady

Následující příklad vytvoří objekt a pak ho OracleCommand spustí pomocí ExecuteScalarpříkazu . Příklad je předán řetězec, který je příkaz SQL, který vrací agregovaný výsledek, a řetězec, který se má použít pro připojení k databázi.

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

Poznámky

Použijte metodu ExecuteScalar k načtení jedné hodnoty (například agregační hodnoty) z databáze. To vyžaduje méně kódu než použití ExecuteReader metody a provedení operací potřebných k vygenerování jedné hodnoty z dat vrácených objektem OracleDataReader.

Typický ExecuteScalar dotaz je možné naformátovat jako v následujícím příkladu jazyka C#:

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

Platí pro

Viz také