OracleCommand.ExecuteNonQuery Método

Definição

Namespace:
System.Data.OracleClient
Assembly:
System.Data.OracleClient.dll

Executa uma instrução Connection SQL e retorna o número de linhas afetadas.

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

Retornos

Int32

Para instruções UPDATE, INSERT e DELETE, o valor retornado é o número de linhas afetadas pelo comando. Para instruções CREATE TABLE e DROP TABLE, o valor retornado é 0. Para todos os outros tipos de instruções, o valor retornado é -1.

Implementações

ExecuteNonQuery()

Exceções

InvalidOperationException

A conexão não existe.

-ou-

A conexão não está aberta.

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, sem usar um DataSet, 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 instruções CREATE TABLE e DROP TABLE, o valor retornado é 0. Para todos os outros tipos de instruções, o valor retornado é -1. Se ocorrer uma reversão, o valor retornado também será -1.

Aplica-se a

Confira também