OracleCommand.ExecuteOracleNonQuery(OracleString) Método

Definição

Executa uma instrução SQL contra o Connection e devolve 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 base64 string do ID real da linha no servidor.

Devoluções

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

Exceções

A ligação não existe.

-ou-

A ligação não está aberta.

Observações

Pode usar ExecuteOracleNonQuery para realizar operações de catálogo (por exemplo, consultar a estrutura de uma base de dados ou criar objetos de base de dados como tabelas); ou para alterar os dados numa base de dados, sem usar um DataSet, executando instruções UPDATE, INSERT ou DELETE.

ExecuteOracleNonQuery difere de ExecuteNonQuery que retorna rowid como parâmetro de saída se estiver a executar uma instrução INSERT, DELETE ou UPDATE que afeta exatamente uma linha. Isto permite-lhe identificar de forma única uma linha na base de dados da Oracle, o que lhe permite aumentar o desempenho em consultas subsequentes relacionadas.

Embora ExecuteOracleNonQuery não devolva linhas, quaisquer parâmetros de saída ou valores de retorno mapeados para parâmetros são preenchidos com dados.

Aplica-se a

Ver também