OracleCommand.ExecuteNonQuery Método

Definição

Executa uma instrução SQL no Connection 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

Exceções

A conexão não existe.

- ou -

A conexão não está aberta.

Exemplos

O exemplo a seguir cria um OracleCommand e o executa usando ExecuteNonQuery. O exemplo é passado uma cadeia de caracteres que é uma instrução SQL (como UPDATE, INSERT ou DELETE) e uma cadeia de caracteres a ser usada para se conectar ao banco de dados.

public void CreateOracleCommand(string myExecuteQuery, string connectionString)
{
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(myExecuteQuery, connection);
        command.Connection.Open();
        command.ExecuteNonQuery();
    }
}
Public Sub CreateOracleCommand(ByVal myExecuteQuery As String, _
ByVal connectionString As String)
    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(myExecuteQuery, connection)
        command.Connection.Open()
        command.ExecuteNonQuery()
    End Using
End Sub

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, quaisquer parâmetros de saída ou valores de retorno 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