Compartilhar via


OracleCommand.ExecuteOracleNonQuery(OracleString) Método

Definição

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

public:
 int ExecuteOracleNonQuery([Runtime::InteropServices::Out] System::Data::OracleClient::OracleString % rowid);
public int ExecuteOracleNonQuery (out System.Data.OracleClient.OracleString rowid);
member this.ExecuteOracleNonQuery : OracleString -> int
Public Function ExecuteOracleNonQuery (ByRef rowid As OracleString) As Integer

Parâmetros

rowid
OracleString

Uma representação de cadeia de caracteres base64 da ID da linha real no servidor.

Retornos

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.

Exceções

A conexão não existe.

- ou -

A conexão não está aberta.

Comentários

Você pode usar ExecuteOracleNonQuery 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.

ExecuteOracleNonQuery difere de ExecuteNonQuery em que ele retorna rowid como um parâmetro de saída se você estiver executando uma instrução INSERT, DELETE ou UPDATE que afeta exatamente uma linha. Isso permite identificar exclusivamente uma linha no banco de dados Oracle, o que pode permitir que você aumente o desempenho em consultas relacionadas subsequentes.

Embora ExecuteOracleNonQuery não retorne nenhuma linha, os parâmetros de saída ou valores retornados mapeados para parâmetros são preenchidos com dados.

Aplica-se a

Confira também