SqlBatch.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 o lote em seu objeto de conexão, retornando o número total de linhas afetadas em todos os comandos do lote.
public:
override int ExecuteNonQuery();
public override int ExecuteNonQuery ();
override this.ExecuteNonQuery : unit -> int
Public Overrides Function ExecuteNonQuery () As Integer
Retornos
O número total de linhas afetadas em todos os comandos do lote.
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 executando instruções UPDATE, INSERT ou DELETE.
Embora ExecuteNonQuery não retorne nenhuma linha, quaisquer 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 total de linhas afetadas pelo lote. Se nenhuma instrução UPDATE, INSERT ou DELETE for incluída no lote, o valor retornado será -1.
Observação
Esse método se beneficia de ExecuteNonQuery()e todas as exceções esperadas desse método também se aplicam aqui.