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 um procedimento armazenado a ser executado 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

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 Connection SQL 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 do .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 valor 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 do .NET Framework (SQL Server, OLE DB e ODBC), o OracleCommand objeto não dá suporte a uma CommandTimeout propriedade. Definir um tempo limite de comando não tem efeito e o valor retornado é sempre zero.

Construtores

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

Propriedades

Nome	Description
CanRaiseEvents	Obsoleto. Obtém um valor que indica se o componente pode gerar 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 gerar um erro.
CommandType	Obsoleto. Obtém ou define um valor que indica como a CommandText propriedade é interpretada.
Connection	Obsoleto. Obtém ou define o OracleConnection usado por esta 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 por isso DbCommand. (Herdado de DbCommand)
DbParameterCollection	Obsoleto. Obtém a coleção de DbParameter objetos. (Herdado de DbCommand)
DbTransaction	Obsoleto. Obtém ou define o DbTransaction interior no qual este DbCommand objeto é 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 de interface personalizado.
Events	Obsoleto. Obtém a lista de manipuladores de eventos anexados a isso Component. (Herdado de Component)
Parameters	Obsoleto. Obtém OracleParameterCollection.
Site	Obsoleto. Obtém ou define o ISiteComponent. (Herdado de Component)
Transaction	Obsoleto. Obtém ou define o OracleTransaction interior no qual a OracleCommand execução é executada.
UpdatedRowSource	Obsoleto. Obtém ou define um valor que especifica como o Update método deve aplicar resultados de comando ao DataRow.

Métodos

Nome	Description
Cancel()	Obsoleto. Tenta cancelar a execução de um OracleCommand.
Clone()	Obsoleto. Cria uma cópia desse OracleCommand objeto.
CreateDbParameter()	Obsoleto. Cria uma nova instância de um DbParameter objeto. (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 OracleParameter objeto.
Equals(Object)	Obsoleto. Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
ExecuteDbDataReader(CommandBehavior)	Obsoleto. Executa o comando em relação à 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 ExecuteReader sobrecargas. A implementação padrão invoca o método síncrono ExecuteReader() e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se passar um token de cancelamento já cancelado. As exceções geradas pelo ExecuteReader serão comunicadas por meio da propriedade de Exceção de Tarefa retornada. Esse método aceita um token de cancelamento que pode ser usado para solicitar que a operação seja cancelada antecipadamente. As implementações podem ignorar essa solicitação. (Herdado de DbCommand)
ExecuteNonQuery()	Obsoleto. Executa uma instrução Connection SQL 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. ExecuteNonQueryAsync(CancellationToken) Invoca com CancellationToken.None. (Herdado de DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Obsoleto. Esta é a versão assíncrona de ExecuteNonQuery(). Os 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 síncrono ExecuteNonQuery() e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se passar um token de cancelamento já cancelado. As exceções geradas serão comunicadas por ExecuteNonQuery() meio da propriedade de Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do DbCommand objeto até que a Tarefa retornada seja concluída. (Herdado de DbCommand)
ExecuteOracleNonQuery(OracleString)	Obsoleto. Executa uma instrução Connection SQL e retorna o número de linhas afetadas.
ExecuteOracleScalar()	Obsoleto. Executa a consulta e retorna a primeira coluna da primeira linha no conjunto de resultados retornado pela consulta como um tipo de dados específico do Oracle. Colunas ou linhas extras são ignoradas.
ExecuteReader()	Obsoleto. Envia o CommandText para o Connection e cria um OracleDataReader.
ExecuteReader(CommandBehavior)	Obsoleto. Envia o CommandText para o Connectione cria um OracleDataReader usando um dos CommandBehavior valores.
ExecuteReaderAsync()	Obsoleto. Uma versão assíncrona de ExecuteReader, que executa o comando em relação à sua conexão, retornando uma DbDataReader que pode ser usada para acessar os resultados. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Invoca com CancellationToken.None. (Herdado de DbCommand)
ExecuteReaderAsync(CancellationToken)	Obsoleto. Uma versão assíncrona de ExecuteReader, que executa o comando em relação à sua conexão, retornando uma DbDataReader que pode ser usada para acessar os resultados. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invoca . (Herdado de DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Obsoleto. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invoca . (Herdado de DbCommand)
ExecuteReaderAsync(CommandBehavior)	Obsoleto. Uma versão assíncrona de ExecuteReader, que executa o comando em relação à sua conexão, retornando uma DbDataReader que pode ser usada para acessar os resultados. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invoca . (Herdado de DbCommand)
ExecuteScalar()	Obsoleto. Executa a consulta e retorna a primeira coluna da primeira linha no conjunto de resultados retornado pela consulta como um tipo de dados .NET. Colunas ou linhas extras 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. ExecuteScalarAsync(CancellationToken) Invoca com CancellationToken.None. (Herdado de DbCommand)
ExecuteScalarAsync(CancellationToken)	Obsoleto. Esta é a versão assíncrona de ExecuteScalar(). Os 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 síncrono ExecuteScalar() e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se passar um token de cancelamento já cancelado. As exceções geradas pelo ExecuteScalar serão comunicadas por meio da propriedade de Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do DbCommand objeto até que a Tarefa retornada seja 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 tempo de vida para essa instância. (Herdado de MarshalByRefObject)
GetService(Type)	Obsoleto. Retorna um objeto que representa um serviço fornecido pelo Component ou por sua 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 dessa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Obsoleto. Cria uma cópia superficial do Objectatual. (Herdado de Object)
MemberwiseClone(Boolean)	Obsoleto. Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject)
Prepare()	Obsoleto. Cria uma versão preparada (ou compilada) do comando na fonte de dados.
ResetCommandTimeout()	Obsoleto. Redefine a CommandTimeout propriedade 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

Nome	Description
Disposed	Obsoleto. Ocorre quando o componente é descartado por uma chamada para o Dispose() método. (Herdado de Component)

Implantações explícitas de interface

Nome	Description
IDbCommand.Connection	Obsoleto. Obtém ou define o IDbConnection usado por esta instância do IDbCommand. (Herdado de DbCommand)
IDbCommand.CreateParameter()	Obsoleto. Cria uma nova instância de um IDbDataParameter objeto. (Herdado de DbCommand)
IDbCommand.ExecuteReader()	Obsoleto. Executa o CommandText contra e Connection cria um IDataReader. (Herdado de DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	Obsoleto. Executa o CommandText contra e Connectioncria um usando um IDataReader dos CommandBehavior valores. (Herdado de DbCommand)
IDbCommand.Parameters	Obsoleto. Obtém IDataParameterCollection. (Herdado de DbCommand)
IDbCommand.Transaction	Obsoleto. Obtém ou define o DbTransaction interior no qual este DbCommand objeto é executado. (Herdado de DbCommand)

Confira também

• Trabalhando com comandos