Partage via


DbCommand.ExecuteScalar Méthode

Définition

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.

S’applique à

Voir aussi