DbCommand.ExecuteScalar Méthode

Définition

En cas de substitution dans une classe dérivée, exécute la requête et retourne la première colonne de la première ligne du jeu de résultats retourné par la requête. Toutes les autres colonnes et lignes sont ignorées.

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

Object

Première colonne de la première ligne du 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 à la génération de la valeur unique à l’aide des données retournées par 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 .

S’applique à

Voir aussi