SqlCeCommand.ExecuteScalar Method

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 (dans system.data.sqlserverce.dll)

Syntaxe

'Déclaration
Public Overrides Function ExecuteScalar As Object

public override Object ExecuteScalar ()

public:
virtual Object^ ExecuteScalar () override

public Object ExecuteScalar ()

public override function ExecuteScalar () : Object

Valeur de retour

Première colonne de la première ligne du jeu de résultats.

Exceptions

Remarques

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.

Exemple

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

Sécurité des threads

Tout membre statique public (Partagé dans Microsoft Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme sûrs.

Plateformes

Plateformes de développement

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informations sur la version
.NET Framework et NET Compact Framework
Pris en charge dans 3.5
.NET Framework
Pris en charge dans 3.0
.NET Compact Framework et .Net Framework
Pris en charge dans 2.0

Voir aussi

Référence

SqlCeCommand Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace