OracleCommand.ExecuteScalar Metodo

Definizione

Spazio dei nomi:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Esegue la query e restituisce la prima colonna della prima riga nel gruppo di risultati restituito dalla query come tipo di dati .NET. Le colonne o le righe aggiuntive vengono ignorate.

public:
 override System::Object ^ ExecuteScalar();

public override object ExecuteScalar ();

override this.ExecuteScalar : unit -> obj

Public Overrides Function ExecuteScalar () As Object

Restituisce

Object

Prima colonna della prima riga del gruppo di risultati come tipo di dati .NET o riferimento null se il gruppo di risultati è vuoto o il risultato è REF CURSOR.

Esempio

Nell'esempio seguente viene creato un oggetto OracleCommand e quindi viene eseguito usando ExecuteScalar. Nell'esempio viene passata una stringa che rappresenta un'istruzione SQL che restituisce un risultato aggregato e una stringa da usare per connettersi al database.

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

Commenti

Utilizzare il ExecuteScalar metodo per recuperare un singolo valore , ad esempio un valore di aggregazione, da un database. Questo richiede meno codice rispetto all'uso del metodo e quindi l'esecuzione ExecuteReader delle operazioni necessarie per generare il singolo valore dai dati restituiti da un OracleDataReaderoggetto .

Una query tipica ExecuteScalar può essere formattata come nell'esempio C# seguente:

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

Vedi anche

• Uso dei comandi