OracleCommand.ExecuteScalar Méthode

  • Référence

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:
 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

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.

Implémente

ExecuteScalar()

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();

S’applique à

Voir aussi