SqlCeCommand.ExecuteNonQuery Method
Ejecuta una instrucción SQL en SqlCeConnection y devuelve el número de filas afectadas.
Espacio de nombres: System.Data.SqlServerCe
Ensamblado: System.Data.SqlServerCe (en system.data.sqlserverce.dll)
Sintaxis
'Declaración
Public Overrides Function ExecuteNonQuery As Integer
public override int ExecuteNonQuery ()
public:
virtual int ExecuteNonQuery () override
public int ExecuteNonQuery ()
public override function ExecuteNonQuery () : int
Valor devuelto
Número de filas afectadas.
Excepciones
| Tipo de excepción | Condición |
|---|---|
| InvalidOperationException | La conexión no existe. O bien La conexión no está abierta. O bien No se puede ejecutar un comando en un contexto de transacción distinto al contexto en que se dio de alta la conexión originalmente. |
Notas
ExecuteNonQuery se puede utilizar para llevar a cabo operaciones de catálogo. Por ejemplo, se puede utilizar para hacer consultas sobre la estructura de una base de datos o para crear objetos de bases de datos, como tablas. ExecuteNonQuery se puede utilizar también para modificar los datos de una base de datos sin utilizar DataSet mediante la ejecución de instrucciones UPDATE, INSERT o DELETE.
Importante
ExecuteNonQuery no utiliza un cursor y, por consiguiente, no aplica bloqueos a la base de datos. Si desea emitir un comando que requiere un bloqueo, no utilice ExecuteNonQuery. Utilice en su lugar ExecuteReader.
Para las instrucciones UPDATE, INSERT y DELETE, el valor devuelto corresponde al número de filas afectadas por el comando. Para el resto de instrucciones DML, el valor devuelto es -1.
Para las instrucciones DDL, como CREATE TABLE o ALTER TABLE, el valor devuelto es 0.
Nota
Este comportamiento no es el mismo que el de System.Data.SqlClient.
Ejemplo
En el siguiente ejemplo se crea un SqlCeCommand y, a continuación, se ejecuta mediante ExecuteNonQuery. En el ejemplo se pasa una cadena que es una instrucción SQL (como UPDATE, INSERT o DELETE) y una cadena para conectarse al origen de datos.
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();
Seguridad para subprocesos
Todos los miembros (Compartidos en Microsoft Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.
Plataformas
Plataformas de desarrollo
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
Información de la versión
.NET Framework y NET Compact Framework
Se admite en 3.5
.NET Framework
Se admite en 3.0
.NET Compact Framework y .Net Framework
Se admite en 2.0
Vea también
Referencia
SqlCeCommand Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace