OdbcCommand.ExecuteNonQuery Método

Definición

Ejecuta una instrucción SQL en Connection y devuelve el número de filas afectadas.

public:
 override int ExecuteNonQuery();
public:
 virtual int ExecuteNonQuery();
public override int ExecuteNonQuery ();
public int ExecuteNonQuery ();
override this.ExecuteNonQuery : unit -> int
abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
Public Overrides Function ExecuteNonQuery () As Integer
Public Function ExecuteNonQuery () As Integer

Devoluciones

Para las instrucciones UPDATE, INSERT y DELETE, el valor devuelto corresponde al número de filas afectadas por el comando. Para los demás tipos de instrucciones, el valor devuelto es -1.

Implementaciones

Excepciones

La conexión no existe.

O bien

La conexión no está abierta.

Comentarios

Puede usar ExecuteNonQuery para realizar operaciones de catálogo (por ejemplo, consultar la estructura de una base de datos o crear objetos de base de datos como tablas); o para cambiar los datos de una base de datos, sin usar DataSet, ejecutando instrucciones UPDATE, INSERT o DELETE.

También puede usar ExecuteNonQuery para ejecutar varias instrucciones SQL si el controlador ODBC subyacente admite esta funcionalidad. En este caso, el valor devuelto es el número de filas afectadas por todas las instrucciones del comando.

Aunque ExecuteNonQuery no devuelve ninguna fila, los parámetros de salida o los valores devueltos asignados a los parámetros se rellenan con datos.

Para las instrucciones UPDATE, INSERT y DELETE, el valor devuelto corresponde al número de filas afectadas por el comando. Para los demás tipos de instrucciones, el valor devuelto es -1. Si se produce una reversión, el valor devuelto también es -1.

Cuando existe un desencadenador en una tabla y los datos se agregan o cambian en la tabla, el valor devuelto incluye el número de filas afectadas por la operación de inserción o actualización y el número de filas afectadas por el desencadenador o desencadenadores.

Se aplica a

Consulte también