IDbCommand.ExecuteScalar Méthode

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

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 ();

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 un instance de la classe dérivée, SqlCommand, puis l’exécute à l’aide ExecuteScalarde . L’exemple montre comment transmettre 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 requête classique ExecuteScalar 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 en Visual Basic) est retournée. Si la valeur dans la base de données est null, la requête retourne DBNull.Value.