SqlCeCommand.ExecuteNonQuery Método
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
'Uso
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
Valor devuelto
Tipo: System.Int32
Número de filas afectadas.
Implementa
Excepciones
| 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. |
Comentarios
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.
Ejemplos
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();