DbCommand.ExecuteNonQuery Método

Definição

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Origem:

DbCommand.cs

Executa o comando em relação ao objeto de conexão, retornando o número de linhas afetadas.

public:
 abstract int ExecuteNonQuery();

public abstract int ExecuteNonQuery ();

abstract member ExecuteNonQuery : unit -> int

Public MustOverride Function ExecuteNonQuery () As Integer

Retornos

Int32

O número de linhas afetadas.

Implementações

ExecuteNonQuery()

Comentários

Você pode usar ExecuteNonQuery para executar operações de catálogo (por exemplo, consultando a estrutura de um banco de dados ou criando 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, 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.

Confira também

• Visão geral do ADO.NET