Compartilhar via


SqlBatch.ExecuteNonQuery Método

Definição

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.

Aplica-se a