OdbcCommand.ExecuteNonQuery Método

Definição

Executa uma instrução SQL no Connection e retorna o número de linhas afetadas.Executes an SQL statement against the Connection and returns the number of rows affected.

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

Retornos

Para instruções UPDATE, INSERT e DELETE, o valor retornado é o número de linhas afetadas pelo comando.For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. Para todos os outros tipos de instruções, o valor retornado é -1.For all other types of statements, the return value is -1.

Exceções

A conexão não existe.The connection does not exist.

- ou --or-

A conexão não está aberta.The connection is not open.

Comentários

Você pode usar ExecuteNonQuery para executar operações de catálogo (por exemplo, consultar a estrutura de um banco de dados ou criar objetos de banco de dados, como tabelas); ou para alterar os dados em um banco de dado, sem usar um DataSet, executando as instruções UPDATE, INSERT ou 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.

Você também pode usar ExecuteNonQuery para executar várias instruções SQL se o driver ODBC subjacente oferecer suporte a essa funcionalidade.You can also use ExecuteNonQuery to execute multiple SQL statements if the underlying ODBC driver supports this functionality. Nesse caso, o valor de retorno é o número de linhas afetadas por todas as instruções no comando.In this case, the return value is the number of rows affected by all statements in the command.

Embora ExecuteNonQuery não retorne nenhuma linha, quaisquer parâmetros de saída ou valores de retorno mapeados para parâmetros são populados com dados.Although ExecuteNonQuery returns no rows, any output parameters or return values mapped to parameters are populated with data.

Para instruções UPDATE, INSERT e DELETE, o valor retornado é o número de linhas afetadas pelo comando.For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. Para todos os outros tipos de instruções, o valor retornado é -1.For all other types of statements, the return value is -1. Se ocorrer uma reversão, o valor de retorno também será-1.If a rollback occurs, the return value is also -1.

Quando existe um gatilho em uma tabela e os dados são adicionados ou alterados na tabela, o valor de retorno inclui o número de linhas afetadas pela operação de inserção ou atualização e o número de linhas afetadas pelo gatilho ou gatilhos.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.

Aplica-se a

Veja também