OleDbCommand.ExecuteScalar Méthode

Définition

Espace de noms:
System.Data.OleDb
Assembly:
System.Data.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. Des colonnes ou des 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

La première colonne de la première ligne du jeu de résultats ou une référence Null si le jeu de résultats est vide.

Implémente

ExecuteScalar()

Exceptions

InvalidOperationException

Impossible d’exécuter une commande dans un contexte de transaction qui diffère du contexte dans lequel la connexion a été initialement inscrite.

Exemples

L’exemple suivant crée un OleDbCommand élément, 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 d’utiliser la ExecuteReader méthode, puis d’effectuer les opérations requises 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();

S’applique à

Voir aussi