Méthode SqlCeCommand.ExecuteScalar

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

Espace de noms :  System.Data.SqlServerCe
Assembly :  System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

Syntaxe

'Déclaration
Public Overrides Function ExecuteScalar As Object
'Utilisation
Dim instance As SqlCeCommand
Dim returnValue As Object

returnValue = instance.ExecuteScalar()

public override Object ExecuteScalar()

public:
virtual Object^ ExecuteScalar() override

abstract ExecuteScalar : unit -> Object 
override ExecuteScalar : unit -> Object 

public override function ExecuteScalar() : Object

Valeur de retour

Type : System.Object
Première colonne de la première ligne du jeu de résultats.

Implémente

IDbCommand.ExecuteScalar()

Exceptions

Notes

Utilisez la méthode ExecuteScalar pour récupérer une valeur unique (par exemple, une valeur d'agrégation) d'une source de données. Cela nécessite moins de code que si vous utilisiez la méthode ExecuteReader en effectuant ensuite les opérations requises pour générer la valeur unique à l'aide des données retournées par SqlCeDataReader.

Exemples

L'exemple suivant crée un SqlCeCommand, puis l'exécute à l'aide de ExecuteScalar. Une chaîne qui est une instruction SQL retournant un résultat d'agrégation et une chaîne à utiliser pour se connecter à la source de données sont passées à l'exemple.

Dim cmd As New SqlCeCommand("SELECT col1 FROM myTable", conn)
cmd.Connection.Open()
Dim value As Object = cmd.ExecuteScalar()
conn.Close()

SqlCeCommand cmd = new SqlCeCommand("SELECT col1 FROM myTable", conn);
cmd.Connection.Open();
object value = cmd.ExecuteScalar();
conn.Close();

Voir aussi

Référence

SqlCeCommand Classe

Espace de noms System.Data.SqlServerCe