OdbcCommand.ExecuteNonQuery Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Exécute une instruction SQL sur Connection et retourne le nombre de lignes affectées.
public:
override int ExecuteNonQuery();public:
virtual int ExecuteNonQuery();public override int ExecuteNonQuery ();public int ExecuteNonQuery ();override this.ExecuteNonQuery : unit -> intabstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> intPublic Overrides Function ExecuteNonQuery () As IntegerPublic Function ExecuteNonQuery () As IntegerRetours
Pour les instructions UPDATE, INSERT et DELETE, les valeurs de retour représentent le nombre de lignes affectées par la commande. Pour tous les autres types d'instructions, la valeur de retour est -1.
Implémente
Exceptions
Remarques
Vous pouvez utiliser ExecuteNonQuery pour effectuer des opérations de catalogue (par exemple, interroger la structure d’une base de données ou créer des objets de base de données tels que des tables) ou pour modifier les données d’une base de données, sans utiliser de DataSet, en exécutant des instructions UPDATE, INSERT ou DELETE.
Vous pouvez également utiliser ExecuteNonQuery pour exécuter plusieurs instructions SQL si le pilote ODBC sous-jacent prend en charge cette fonctionnalité. Dans ce cas, la valeur de retour correspond au nombre de lignes affectées par toutes les instructions de la commande.
Bien que ExecuteNonQuery ne retourne aucune ligne, les paramètres de sortie ou valeurs de retour mappés aux paramètres sont renseignés avec des données.
Pour les instructions UPDATE, INSERT et DELETE, les valeurs de retour représentent le nombre de lignes affectées par la commande. Pour tous les autres types d'instructions, la valeur de retour est -1. Si une restauration se produit, la valeur de retour est également -1.
Lorsqu’un déclencheur existe sur une table et que des données sont ajoutées ou modifiées dans la table, la valeur de retour inclut le nombre de lignes affectées par l’opération d’insertion ou de mise à jour et le nombre de lignes affectées par le ou les déclencheurs.
