OleDbCommand.ExecuteScalar Méthode

Définition

Espace de noms:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Paquet:

System.Data.OleDb v8.0.0

Source:

OleDbCommand.cs

Exécute la requête et retourne la première colonne de la première ligne dans le jeu de résultats retourné par la requête. 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 dans le jeu de résultats, ou référence Null si le jeu de résultats est vide.

Implémente

ExecuteScalar()

Exceptions

InvalidOperationException

Impossible d'exécuter une commande au sein d'un contexte de transaction différent de celui dans lequel la connexion a été inscrite à l'origine.

Exemples

L’exemple suivant crée un OleDbCommand , puis l’exécute à l’aide ExecuteScalarde . L’exemple est passé 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 source de données.

public void CreateMyOleDbCommand(string queryString,
    OleDbConnection connection)
{
    OleDbCommand command = new OleDbCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

Public Sub CreateMyOleDbCommand(queryString As String, _
    connection As OleDbConnection)
    Dim command As New OleDbCommand(queryString, 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 source 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 à l’aide des données retournées par un OleDbDataReader.

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