SqlCeCommand.ExecuteNonQuery Method

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 (dans system.data.sqlserverce.dll)

Syntaxe

'Déclaration
Public Overrides Function ExecuteNonQuery As Integer

public override int ExecuteNonQuery ()

public:
virtual int ExecuteNonQuery () override

public int ExecuteNonQuery ()

public override function ExecuteNonQuery () : int

Valeur de retour

Nombre de lignes affectées.

Exceptions

Remarques

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.

Remarque :
Ce comportement diffère de celui de System.Data.SqlClient.

Exemple

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

Sécurité des threads

Tout membre statique public (Partagé dans Microsoft Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme sûrs.

Plateformes

Plateformes de développement

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informations sur la version
.NET Framework et NET Compact Framework
Pris en charge dans 3.5
.NET Framework
Pris en charge dans 3.0
.NET Compact Framework et .Net Framework
Pris en charge dans 2.0

Voir aussi

Référence

SqlCeCommand Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace