OleDbCommand.ExecuteScalar Méthode

Définition

Exécute la requête et retourne la première colonne de la première ligne dans le jeu de résultats retourné par la requête. Les colonnes ou lignes supplémentaires sont ignorées.

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

Retours

Object

Première colonne de la première ligne dans le jeu de résultats, ou référence Null si le jeu de résultats est vide.

Implémente

Exceptions

Impossible d'exécuter une commande au sein d'un contexte de transaction différent de celui dans lequel la connexion a été inscrite à l'origine.

Exemples

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

public void CreateMyOleDbCommand(string queryString,
    OleDbConnection connection)
{
    OleDbCommand command = new OleDbCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}
Public Sub CreateMyOleDbCommand(queryString As String, _
    connection As OleDbConnection)
    Dim command As New OleDbCommand(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 source de données. Cela nécessite moins de code que l’utilisation de la ExecuteReader méthode, puis l’exécution des opérations requises pour générer la valeur unique à l’aide des données retournées par un OleDbDataReader .

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

CommandText = "SELECT COUNT(*) FROM region";  
Int32 count = (int32) ExecuteScalar();  

S’applique à

Voir aussi