OracleCommand.ExecuteScalar Méthode

Définition

Espace de noms:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Exécute la requête et retourne la première colonne de la première ligne du jeu de résultats retourné par la requête dans le type de données .NET. Les colonnes ou lignes supplémentaires sont ignorées.

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

public override object ExecuteScalar ();

override this.ExecuteScalar : unit -> obj

Public Overrides Function ExecuteScalar () As Object

Retours

Object

Première colonne de la première ligne du jeu de résultats dans le type de données .NET ou référence null si le jeu de résultats est vide ou si le résultat est un REF CURSOR.

Exemples

L’exemple suivant crée un OracleCommand , puis l’exécute à l’aide ExecuteScalarde . L’exemple est transmis à une chaîne qui est une instruction SQL qui retourne un résultat d’agrégation et une chaîne à utiliser pour se connecter à la base de données.

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

Remarques

Utilisez la ExecuteScalar méthode pour récupérer une valeur unique (par exemple, une valeur d’agrégation) à partir d’une base de données. Cela nécessite moins de code que l’utilisation de la ExecuteReader méthode , puis l’exécution des opérations nécessaires pour générer la valeur unique à partir des données retournées par un OracleDataReader.

Une requête classique ExecuteScalar peut être mise en forme comme dans l’exemple C# suivant :

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

Voir aussi

• Utilisation des commandes