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 ();
public abstract object? ExecuteScalar ();
abstract member ExecuteScalar : unit -> obj
Public MustOverride Function ExecuteScalar () As Object
Retours
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 l’utilisation de la ExecuteReader méthode et l’exécution des 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
en Visual Basic) est retournée. Si la valeur dans la base de données est null
, la requête retourne DBNull.Value
.