Méthode SqlCeCommand.ExecuteNonQuery
Exécute une instruction SQL sur SqlCeConnection et retourne le nombre de lignes affectées.
Espace de noms : System.Data.SqlServerCe
Assembly : System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)
Syntaxe
'Déclaration
Public Overrides Function ExecuteNonQuery As Integer
'Utilisation
Dim instance As SqlCeCommand
Dim returnValue As Integer
returnValue = instance.ExecuteNonQuery()
public override int ExecuteNonQuery()
public:
virtual int ExecuteNonQuery() override
abstract ExecuteNonQuery : unit -> int
override ExecuteNonQuery : unit -> int
public override function ExecuteNonQuery() : int
Valeur de retour
Type : System.Int32
Nombre de lignes affectées.
Implémente
Exceptions
| Exception | Condition |
|---|---|
| InvalidOperationException | La connexion n'existe pas. -ou- La connexion n'est pas ouverte. -ou- 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. |
Notes
Vous pouvez utiliser ExecuteNonQuery pour effectuer des opérations portant sur un catalogue. Par exemple, vous pouvez l'utiliser pour interroger la structure d'une base de données ou créer des objets de base de données tels que des tables. Vous pouvez également utiliser ExecuteNonQuery pour modifier les données d'une base de données sans recourir à DataSet en exécutant des instructions UPDATE, INSERT ou DELETE.
Important
ExecuteNonQuery n'utilise pas de curseur, et ne place donc pas de verrous sur la base de données. Si vous publiez une commande nécessitant un verrou, n'utilisez pas ExecuteNonQuery. Utilisez plutôt ExecuteReader.
Pour les instructions UPDATE, INSERT et DELETE, les valeurs de retour représentent le nombre de lignes affectées par la commande. Pour toutes les autres instructions DML, la valeur de retour est -1.
Pour les instructions DDL, telles que CREATE TABLE ou ALTER TABLE, la valeur de retour est 0.
Notes
Ce comportement diffère de celui de System.Data.SqlClient.
Exemples
L'exemple suivant crée SqlCeCommand, puis l'exécute à l'aide de ExecuteNonQuery. Une chaîne qui est une instruction SQL (telle que UPDATE, INSERT ou DELETE) et une chaîne à utiliser pour se connecter à la source de données sont passées à l'exemple.
conn.Open()
Dim cmd As New SqlCeCommand("INSERT INTO foo (col1) VALUES (1)", conn)
cmd.ExecuteNonQuery()
conn.Close()
conn.Open();
SqlCeCommand cmd = new SqlCeCommand("INSERT INTO foo (col1) VALUES (1)", conn);
cmd.ExecuteNonQuery();
conn.Close();