OdbcCommand.ExecuteNonQuery Método

Definición

Ejecuta una instrucción SQL en Connection y devuelve el número de filas afectadas.Executes an SQL statement against the Connection and returns the number of rows affected.

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

Int32

Para las instrucciones UPDATE, INSERT y DELETE, el valor devuelto corresponde al número de filas afectadas por el comando.For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. Para los demás tipos de instrucciones, el valor devuelto es -1.For all other types of statements, the return value is -1.

Implementaciones

Excepciones

La conexión no existe.The connection does not exist.

O bien-or-

La conexión no está abierta.The connection is not open.

Comentarios

Puede utilizar ExecuteNonQuery para realizar operaciones de catálogo (por ejemplo, para consultar la estructura de una base de datos o para crear objetos de base de datos como tablas); o para cambiar los datos de una base de datos, sin usar DataSet , mediante la ejecución de instrucciones Update, INSERT o DELETE.You can use ExecuteNonQuery to perform catalog operations (for example, querying the structure of a database or creating database objects such as tables); or to change the data in a database, without using a DataSet, by executing UPDATE, INSERT, or DELETE statements.

También puede utilizar ExecuteNonQuery para ejecutar varias instrucciones SQL si el controlador ODBC subyacente es compatible con esta funcionalidad.You can also use ExecuteNonQuery to execute multiple SQL statements if the underlying ODBC driver supports this functionality. En este caso, el valor devuelto es el número de filas afectadas por todas las instrucciones del comando.In this case, the return value is the number of rows affected by all statements in the command.

Aunque ExecuteNonQuery no devuelve ninguna fila, los parámetros de salida o los valores devueltos asignados a los parámetros se rellenan con datos.Although ExecuteNonQuery returns no rows, any output parameters or return values mapped to parameters are populated with data.

Para las instrucciones UPDATE, INSERT y DELETE, el valor devuelto corresponde al número de filas afectadas por el comando.For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. Para los demás tipos de instrucciones, el valor devuelto es -1.For all other types of statements, the return value is -1. Si se produce una reversión, el valor devuelto también es-1.If a rollback occurs, the return value is also -1.

Cuando existe un desencadenador en una tabla y se agregan o cambian datos 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.When a trigger exists on a table and data is being added or changed in the table, the return value includes the number of rows affected by both the insert or update operation and the number of rows affected by the trigger or triggers.

Se aplica a