DbCommand.ExecuteScalar Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Exécute la commande et retourne la première colonne de la première ligne du premier jeu de résultats retourné. Toutes les autres colonnes, lignes et jeux de résultats sont ignorés.
public:
abstract System::Object ^ ExecuteScalar();public abstract object ExecuteScalar();abstract member ExecuteScalar : unit -> objPublic MustOverride Function ExecuteScalar () As ObjectRetours
Première colonne de la première ligne du premier jeu de résultats.
Implémente
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 d’utiliser la ExecuteReader méthode et d’effectuer les opérations nécessaires pour générer la valeur unique à l’aide des données retournées par un DbDataReader.
Si la première colonne de la première ligne du jeu de résultats est introuvable, une référence Null (Nothing dans Visual Basic) est retournée. Si la valeur de la base de données est null, la requête retourne DBNull.Value.