OdbcCommand.ExecuteNonQuery Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Executa uma instrução SQL no Connection e retorna o número de linhas afetadas.
public:
override int ExecuteNonQuery();public:
virtual int ExecuteNonQuery();public override int ExecuteNonQuery ();public int ExecuteNonQuery ();override this.ExecuteNonQuery : unit -> intabstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> intPublic Overrides Function ExecuteNonQuery () As IntegerPublic Function ExecuteNonQuery () As IntegerRetornos
Para instruções UPDATE, INSERT e DELETE, o valor retornado é o número de linhas afetadas pelo comando. Para todos os outros tipos de instruções, o valor retornado é -1.
Implementações
Exceções
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 dados, sem usar um DataSet, executando instruções UPDATE, INSERT ou DELETE.
Você também pode usar ExecuteNonQuery para executar várias instruções SQL se o driver ODBC subjacente der suporte a essa funcionalidade. Nesse caso, o valor retornado é o número de linhas afetadas por todas as instruções no comando .
Embora ExecuteNonQuery não retorne linhas, todos os parâmetros de saída ou valores retornados mapeados para parâmetros são preenchidos com dados.
Para instruções UPDATE, INSERT e DELETE, o valor retornado é o número de linhas afetadas pelo comando. Para todos os outros tipos de instruções, o valor retornado é -1. Se ocorrer uma reversão, o valor retornado também será -1.
Quando um gatilho existe em uma tabela e os dados estão sendo adicionados ou alterados na tabela, o valor retornado 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.
