OracleCommand Classe

Definição

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Cuidado

OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

Representa uma instrução SQL ou procedimento armazenado para execução em um banco de dados. Essa classe não pode ser herdada.

public ref class OracleCommand sealed : System::Data::Common::DbCommand, ICloneable

[System.Obsolete("OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleCommand : System.Data.Common.DbCommand, ICloneable

[<System.Obsolete("OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleCommand = class
    inherit DbCommand
    interface ICloneable

Public NotInheritable Class OracleCommand
Inherits DbCommand
Implements ICloneable

Herança

Object

MarshalByRefObject

Component

DbCommand

OracleCommand

Atributos

ObsoleteAttribute

Implementações

ICloneable

Exemplos

O exemplo a seguir usa o ExecuteReader método de OracleCommand, juntamente com OracleDataReader e OracleConnection, para selecionar linhas de uma tabela.

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT EmpNo, DeptNo FROM Scott.Emp";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(queryString, connection);
        connection.Open();
        OracleDataReader reader = command.ExecuteReader();
        try
        {
            while (reader.Read())
            {
                Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetInt32(1));
            }
        }
        finally
        {
            // always call Close when done reading.
            reader.Close();
        }
    }
}

Public Sub ReadMyData(ByVal connectionString As String)
    Dim queryString As String = "SELECT EmpNo, DeptNo FROM Scott.Emp"
    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(queryString, connection)
        connection.Open()
        Dim reader As OracleDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(reader.GetInt32(0) & ", " _
                   & reader.GetInt32(1))
            End While
        Finally
            ' always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

Comentários

Esse tipo foi preterido e será removido em uma versão futura do .NET Framework. Para obter mais informações, consulte Oracle e ADO.NET.

A OracleCommand classe fornece os seguintes métodos para executar comandos em uma fonte de dados:

Item	Descrição
ExecuteReader	Executa comandos que retornam linhas.
ExecuteOracleNonQuery	Executa uma instrução SQL no Connection e retorna o número de linhas afetadas.
ExecuteNonQuery	Executa comandos como instruções SQL INSERT, DELETE, UPDATE e SET.
ExecuteScalar	Recupera um único valor (por exemplo, um valor agregado) de um banco de dados como um tipo de dados .NET Framework.
ExecuteOracleScalar	Recupera um único valor (por exemplo, um valor agregado) de um banco de dados como um tipo de dados específico do Oracle.

Você pode redefinir a CommandText propriedade e reutilizar o OracleCommand objeto.

Se a execução do comando resultar em um fatal OracleException, o OracleConnection poderá ser fechado. No entanto, o usuário pode reabrir a conexão e continuar.

Observação

Ao contrário do objeto Command em outros provedores de dados .NET Framework (SQL Server, OLE DB e ODBC), o objeto não dá suporte a OracleCommand uma CommandTimeout propriedade . Definir um tempo limite de comando não tem efeito e o valor retornado é sempre zero.

Construtores

OracleCommand()	Obsoleto. Inicializa uma nova instância do OracleCommand.
OracleCommand(String)	Obsoleto. Inicializa uma nova instância da classe OracleCommand com o texto da consulta.
OracleCommand(String, OracleConnection)	Obsoleto. Inicializa uma nova instância da classe OracleCommand com o texto da consulta e um objeto OracleConnection.
OracleCommand(String, OracleConnection, OracleTransaction)	Obsoleto. Inicializa uma nova instância da classe OracleCommand com o texto da consulta, um objeto OracleConnection e um OracleTransaction.

Propriedades

CanRaiseEvents	Obsoleto. Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component)
CommandText	Obsoleto. Obtém ou define a instrução SQL ou o procedimento armazenado a ser executado no banco de dados.
CommandTimeout	Obsoleto. Obtém ou define o tempo de espera (em segundos) antes de encerrar a tentativa de executar um comando e antes de gerar um erro.
CommandType	Obsoleto. Obtém ou define um valor que indica como a propriedade CommandText é interpretada.
Connection	Obsoleto. Obtém ou define o OracleConnection usado por essa instância do OracleCommand.
Container	Obsoleto. Obtém o IContainer que contém o Component. (Herdado de Component)
DbConnection	Obsoleto. Obtém ou define o DbConnection usado pelo DbCommand. (Herdado de DbCommand)
DbParameterCollection	Obsoleto. Obtém a coleção de objetos DbParameter. (Herdado de DbCommand)
DbTransaction	Obsoleto. Obtém ou define o DbCommand em que este objeto DbTransaction é executado. (Herdado de DbCommand)
DesignMode	Obsoleto. Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component)
DesignTimeVisible	Obsoleto. Obtém ou define um valor que indica se o objeto de comando deve estar visível em um controle da interface personalizada.
Events	Obsoleto. Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component)
Parameters	Obsoleto. Obtém o OracleParameterCollection.
Site	Obsoleto. Obtém ou define o ISite do Component. (Herdado de Component)
Transaction	Obsoleto. Obtém ou define o OracleCommand em que o OracleTransaction é executado.
UpdatedRowSource	Obsoleto. Obtém ou define um valor que especifica como o método Update deve aplicar os resultados do comando ao DataRow.

Métodos

Cancel()	Obsoleto. Tenta cancelar a execução de um OracleCommand.
Clone()	Obsoleto. Cria uma cópia deste objeto OracleCommand.
CreateDbParameter()	Obsoleto. Cria uma nova instância de um objeto DbParameter. (Herdado de DbCommand)
CreateObjRef(Type)	Obsoleto. Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
CreateParameter()	Obsoleto. Cria uma nova instância de um objeto OracleParameter.
Dispose()	Obsoleto. Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. (Herdado de DbCommand)
Dispose(Boolean)	Obsoleto. Libera os recursos não gerenciados usados pelo DbCommand e opcionalmente libera os recursos gerenciados. (Herdado de DbCommand)
DisposeAsync()	Obsoleto. Descarta de forma assíncrona o objeto de comando. (Herdado de DbCommand)
Equals(Object)	Obsoleto. Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
ExecuteDbDataReader(CommandBehavior)	Obsoleto. Executa o comando em sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados. (Herdado de DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Obsoleto. Os provedores devem implementar esse método para fornecer uma implementação não padrão para sobrecargas ExecuteReader. A implementação padrão invoca o método ExecuteReader() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se já tiver passado um token de cancelamento. Exceções geradas por ExecuteReader serão comunicadas por meio da propriedade Exceção de Tarefa retornada. Esse método aceita um token de cancelamento que pode ser usado para solicitar a operação a ser cancelada no início. As implementações podem ignorar essa solicitação. (Herdado de DbCommand)
ExecuteNonQuery()	Obsoleto. Executa uma instrução SQL no Connection e retorna o número de linhas afetadas.
ExecuteNonQueryAsync()	Obsoleto. Uma versão assíncrona de ExecuteNonQuery(), que executa o comando em seu objeto de conexão, retornando o número de linhas afetadas. Invoca ExecuteNonQueryAsync(CancellationToken) com CancellationToken.None. (Herdado de DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Obsoleto. Essa é a versão assíncrona de ExecuteNonQuery(). Provedores devem substituir com uma implementação apropriada. Opcionalmente, o token de cancelamento pode ser ignorado. A implementação padrão invoca o método ExecuteNonQuery() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se já tiver passado um token de cancelamento. Exceções geradas por ExecuteNonQuery() serão comunicadas por meio da propriedade Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do objeto DbCommand até a Tarefa retornada ser concluída. (Herdado de DbCommand)
ExecuteOracleNonQuery(OracleString)	Obsoleto. Executa uma instrução SQL no Connection e retorna o número de linhas afetadas.
ExecuteOracleScalar()	Obsoleto. Executa a consulta e retorna a primeira coluna da primeira linha do conjunto de resultados retornado pela consulta como um tipo de dados específico do Oracle. Colunas ou linhas extra são ignoradas.
ExecuteReader()	Obsoleto. Envia o CommandText para o Connection e cria um OracleDataReader.
ExecuteReader(CommandBehavior)	Obsoleto. Envia o CommandText para o Connection e cria um OracleDataReader usando um dos valores CommandBehavior.
ExecuteReaderAsync()	Obsoleto. Uma versão assíncrona do ExecuteReader, que executa o comando em sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) com CancellationToken.None. (Herdado de DbCommand)
ExecuteReaderAsync(CancellationToken)	Obsoleto. Uma versão assíncrona do ExecuteReader, que executa o comando em sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Herdado de DbCommand)
ExecuteReaderAsync(CommandBehavior)	Obsoleto. Uma versão assíncrona do ExecuteReader, que executa o comando em sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Herdado de DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Obsoleto. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Herdado de DbCommand)
ExecuteScalar()	Obsoleto. Executa a consulta e retorna a primeira coluna da primeira linha do conjunto de resultados retornado pela consulta como um tipo de dados do .NET. Colunas ou linhas extra são ignoradas.
ExecuteScalarAsync()	Obsoleto. Uma versão assíncrona de ExecuteScalar(), que executa o comando e retorna a primeira coluna da primeira linha no primeiro conjunto de resultados retornado. Todas as outras colunas, linhas e conjuntos de resultados são ignorados. Invoca ExecuteScalarAsync(CancellationToken) com CancellationToken.None. (Herdado de DbCommand)
ExecuteScalarAsync(CancellationToken)	Obsoleto. Essa é a versão assíncrona de ExecuteScalar(). Provedores devem substituir com uma implementação apropriada. Opcionalmente, o token de cancelamento pode ser ignorado. A implementação padrão invoca o método ExecuteScalar() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se já tiver passado um token de cancelamento. Exceções geradas por ExecuteScalar serão comunicadas por meio da propriedade Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do objeto DbCommand até a Tarefa retornada ser concluída. (Herdado de DbCommand)
GetHashCode()	Obsoleto. Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetService(Type)	Obsoleto. Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component)
GetType()	Obsoleto. Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Obsoleto. Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Obsoleto. Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
Prepare()	Obsoleto. Cria uma versão preparada (ou compilada) do comando na fonte de dados.
PrepareAsync(CancellationToken)	Obsoleto. Cria de maneira assíncrona uma versão preparada (ou compilada) do comando na fonte de dados. (Herdado de DbCommand)
ResetCommandTimeout()	Obsoleto. Redefine a propriedade CommandTimeout para o valor padrão.
ToString()	Obsoleto. Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído. (Herdado de Component)

Eventos

Disposed

Obsoleto. Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component)

Implantações explícitas de interface

IDbCommand.Connection	Obsoleto. Obtém ou define o IDbConnection usado por essa instância do IDbCommand. (Herdado de DbCommand)
IDbCommand.CreateParameter()	Obsoleto. Cria uma nova instância de um objeto IDbDataParameter. (Herdado de DbCommand)
IDbCommand.ExecuteReader()	Obsoleto. Executa o CommandText no Connection e compila um IDataReader. (Herdado de DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	Obsoleto. Executa o CommandText para o Connection e cria um IDataReader usando um dos valores de CommandBehavior. (Herdado de DbCommand)
IDbCommand.Parameters	Obsoleto. Obtém o IDataParameterCollection. (Herdado de DbCommand)
IDbCommand.Transaction	Obsoleto. Obtém ou define o DbCommand em que este objeto DbTransaction é executado. (Herdado de DbCommand)

Confira também

• Trabalhando com comandos