OdbcCommand.ExecuteNonQuery Método

public:
 virtual int ExecuteNonQuery();

public:
 override int ExecuteNonQuery();

public int ExecuteNonQuery();

public override int ExecuteNonQuery();

abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int

override this.ExecuteNonQuery : unit -> int

Public Function ExecuteNonQuery () As Integer

Public Overrides Function ExecuteNonQuery () As Integer

Devoluções

Para as instruções UPDATE, INSERT e DELETE, o valor de retorno é o número de linhas afetadas pelo comando. Para todos os outros tipos de sentenças, o valor de retorno é -1.

Implementações

Exceções

Observações

Pode usar ExecuteNonQuery para realizar operações de catálogo (por exemplo, consultar a estrutura de uma base de dados ou criar objetos de base de dados como tabelas); ou para alterar os dados numa base de dados, sem usar um DataSet, executando instruções UPDATE, INSERT ou DELETE.

Também pode usar ExecuteNonQuery para executar múltiplas instruções SQL se o driver ODBC subjacente suportar esta funcionalidade. Neste caso, o valor de retorno é o número de linhas afetadas por todas as instruções do comando.

Embora ExecuteNonQuery não dê retornos, quaisquer parâmetros de saída ou valores de retorno mapeados para parâmetros são preenchidos com dados.

Para as instruções UPDATE, INSERT e DELETE, o valor de retorno é o número de linhas afetadas pelo comando. Para todos os outros tipos de sentenças, o valor de retorno é -1. Se ocorrer um rollback, o valor de retorno também é -1.

Quando existe um trigger numa tabela e os dados estão a ser adicionados ou alterados na tabela, o valor de retorno inclui o número de linhas afetadas tanto pela operação de inserção ou atualização como pelo número de linhas afetadas pelo trigger ou triggers.

Ver também

• Executando um comando