IDbCommand.ExecuteScalar Méthode

Définition

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. Les colonnes ou lignes supplémentaires sont ignorées.

public:
 System::Object ^ ExecuteScalar();
public object? ExecuteScalar ();
public object ExecuteScalar ();
abstract member ExecuteScalar : unit -> obj
Public Function ExecuteScalar () As Object

Retours

Object

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

Exemples

L’exemple suivant crée une instance de la classe dérivée, SqlCommand , puis l’exécute à l’aide de ExecuteScalar . l’exemple reçoit une chaîne qui est une instruction Transact-SQL qui retourne un résultat d’agrégation et une chaîne à utiliser pour se connecter à la source de données.

public void CreateSqlCommand(
    string queryString, SqlConnection connection)
{
    SqlCommand command = new
        SqlCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}
Public Sub CreateSqlCommand( _
    queryString As String, connection As SqlConnection)

    Dim command As New SqlCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

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, puis l’exécution des opérations nécessaires pour générer la valeur unique à l’aide des données retournées par un IDataReader .

Une ExecuteScalar requête classique peut être mise en forme comme dans l’exemple C# suivant :

CommandText = "select count(*) as NumberOfRegions from region";  
Int32 count = (int) ExecuteScalar();  

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 à