OracleCommand Classe

Definição

Espaço de Nomes:
System.Data.OracleClient
Assemblagem:
System.Data.OracleClient.dll

Atenção

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

Representa uma instrução SQL ou procedimento armazenado para executar numa base de dados. Esta classe não pode ser herdada.

public ref class OracleCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public ref class OracleCommand sealed : System::Data::Common::DbCommand, ICloneable
public sealed class OracleCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
public sealed class OracleCommand : 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
type OracleCommand = class
    inherit Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable
type OracleCommand = class
    inherit DbCommand
    interface 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 Component
Implements ICloneable, IDbCommand, IDisposable
Public NotInheritable Class OracleCommand
Inherits DbCommand
Implements ICloneable
Herança
Object
MarshalByRefObject
Component
OracleCommand
Herança
Object
MarshalByRefObject
Component
DbCommand
OracleCommand
Atributos
ObsoleteAttribute
Implementações
IDbCommand ICloneable IDisposable

Observações

Este tipo está obsoleto e será removido numa versão futura do .NET Framework. Para mais informações, consulte Oracle e ADO.NET.

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

Número Description
ExecuteReader Executa comandos que devolvem linhas.
ExecuteOracleNonQuery Executa uma instrução SQL contra o Connection e devolve o número de linhas afetadas.
ExecuteNonQuery Executa comandos como SQL INSERT, DELETE, UPDATE e instruções SET.
ExecuteScalar Recupera um único valor (por exemplo, um valor agregado) de uma base de dados como um tipo de dado do .NET Framework.
ExecuteOracleScalar Recupera um único valor (por exemplo, um valor agregado) de uma base de dados como um tipo de dado específico da Oracle.

Podes repor a CommandText propriedade e reutilizar o OracleCommand objeto.

Se a execução do comando resultar num fatal OracleException, o OracleConnection pode fechar. No entanto, o utilizador pode reabrir a ligação e continuar.

Note

Ao contrário do objeto Command nos outros fornecedores de dados do .NET Framework (SQL Server, OLE DB e ODBC), o objeto OracleCommand não suporta uma propriedade CommandTimeout. Definir um timeout de comando não tem efeito e o valor devolvido é sempre zero.

Construtores

Name 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

Name 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 para serem executados contra a base de dados.
CommandTimeout
Obsoleto.

Obtém ou define o tempo de espera (em segundos) antes de terminar a tentativa de executar um comando e gerar um erro.
CommandType
Obsoleto.

Recebe 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 este DbCommand.

(Herdado de DbCommand)
DbParameterCollection
Obsoleto.

Fica com a coleção de DbParameter objetos.

(Herdado de DbCommand)
DbTransaction
Obsoleto.

Obtém ou define o DbTransaction dentro do qual este DbCommand objeto executa.

(Herdado de DbCommand)
DesignMode
Obsoleto.

Obtém um valor que indica se o Component está atualmente em modo de design.

(Herdado de Component)
DesignTimeVisible
Obsoleto.

Recebe ou define um valor que indica se o objeto de comando deve ser visível num controlo de interface personalizado.
Events
Obsoleto.

Obtém a lista de gestores de eventos que estão ligados a isto 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 OracleTransaction dentro do qual executa OracleCommand .
UpdatedRowSource
Obsoleto.

Obtém ou define um valor que especifica como o Update método deve aplicar os resultados dos comandos ao DataRow.

Métodos

Name Description
Cancel()
Obsoleto.

Tenta cancelar a execução de um OracleCommand.
Clone()
Obsoleto.

Cria uma cópia deste 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 toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto.

(Herdado de MarshalByRefObject)
CreateParameter()
Obsoleto.

Cria uma nova instância de um OracleParameter objeto.
Dispose()
Obsoleto.

Liberta todos os recursos utilizados pelo Component.

(Herdado de Component)
Dispose(Boolean)
Obsoleto.

Liberta os recursos não geridos usados pelo Component e opcionalmente liberta os recursos geridos.

(Herdado de Component)
Equals(Object)
Obsoleto.

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
ExecuteDbDataReader(CommandBehavior)
Obsoleto.

Executa o comando contra a sua ligação, devolvendo um DbDataReader que pode ser usado para aceder aos resultados.

(Herdado de DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)
Obsoleto.

Os fornecedores devem implementar este 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 devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas pelo ExecuteReader serão comunicadas através da propriedade de Exceção de Tarefa devolvida.

Este método aceita um token de cancelamento que pode ser usado para pedir que a operação seja cancelada antecipadamente. As implementações podem ignorar este pedido.

(Herdado de DbCommand)
ExecuteNonQuery()
Obsoleto.

Executa uma instrução SQL contra o Connection e devolve o número de linhas afetadas.
ExecuteNonQueryAsync()
Obsoleto.

Uma versão assíncrona de ExecuteNonQuery(), que executa o comando contra o seu objeto de ligação, devolvendo o número de linhas afetadas.

Invoca ExecuteNonQueryAsync(CancellationToken) com CancellationToken.None.

(Herdado de DbCommand)
ExecuteNonQueryAsync(CancellationToken)
Obsoleto.

Esta é a versão assíncrona de ExecuteNonQuery(). Os prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode, opcionalmente, ser ignorado.

A implementação padrão invoca o método síncrono ExecuteNonQuery() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas por ExecuteNonQuery() serão comunicadas através da propriedade de Exceção de Tarefa devolvida.

Não invoque outros métodos e propriedades do DbCommand objeto até que a tarefa devolvida esteja concluída.

(Herdado de DbCommand)
ExecuteOracleNonQuery(OracleString)
Obsoleto.

Executa uma instrução SQL contra o Connection e devolve o número de linhas afetadas.
ExecuteOracleScalar()
Obsoleto.

Executa a consulta e devolve a primeira coluna da primeira linha do conjunto de resultados devolvida pela consulta como um tipo de dado específico da Oracle. Colunas ou linhas extra são ignoradas.
ExecuteReader()
Obsoleto.

Envia o CommandText para e Connection constrói um OracleDataReader.
ExecuteReader(CommandBehavior)
Obsoleto.

Envia o CommandText para o Connection, e constrói um OracleDataReader usando um dos CommandBehavior valores.
ExecuteReaderAsync()
Obsoleto.

Uma versão assíncrona de ExecuteReader, que executa o comando contra a sua ligação, retornando a DbDataReader que pode ser usada para aceder aos resultados.

Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) com CancellationToken.None.

(Herdado de DbCommand)
ExecuteReaderAsync(CancellationToken)
Obsoleto.

Uma versão assíncrona de ExecuteReader, que executa o comando contra a sua ligação, retornando a DbDataReader que pode ser usada para aceder aos resultados.

Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Herdado de DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)
Obsoleto.

Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Herdado de DbCommand)
ExecuteReaderAsync(CommandBehavior)
Obsoleto.

Uma versão assíncrona de ExecuteReader, que executa o comando contra a sua ligação, retornando a DbDataReader que pode ser usada para aceder aos resultados.

Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Herdado de DbCommand)
ExecuteScalar()
Obsoleto.

Executa a consulta e devolve a primeira coluna da primeira linha do conjunto de resultados devolvida pela consulta como um tipo de dado .NET. Colunas ou linhas extra são ignoradas.
ExecuteScalarAsync()
Obsoleto.

Uma versão assíncrona de ExecuteScalar(), que executa o comando e devolve a primeira coluna da primeira linha do primeiro conjunto de resultados devolvido. Todas as outras colunas, linhas e conjuntos de resultados são ignorados.

Invoca ExecuteScalarAsync(CancellationToken) com CancellationToken.None.

(Herdado de DbCommand)
ExecuteScalarAsync(CancellationToken)
Obsoleto.

Esta é a versão assíncrona de ExecuteScalar(). Os prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode, opcionalmente, ser ignorado.

A implementação padrão invoca o método síncrono ExecuteScalar() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas pelo ExecuteScalar serão comunicadas através da propriedade de Exceção de Tarefa devolvida.

Não invoque outros métodos e propriedades do DbCommand objeto até que a tarefa devolvida esteja concluída.

(Herdado de DbCommand)
GetHashCode()
Obsoleto.

Serve como função de hash predefinida.

(Herdado de Object)
GetLifetimeService()
Obsoleto.

Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso.

(Herdado de MarshalByRefObject)
GetService(Type)
Obsoleto.

Devolve 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()
Obsoleto.

Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso.

(Herdado de MarshalByRefObject)
MemberwiseClone()
Obsoleto.

Cria uma cópia superficial do atual Object.

(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.

Reinicia a CommandTimeout propriedade para o valor padrão.
ToString()
Obsoleto.

Devolve a String contendo o nome do Component, se existir. Este método não deve ser ultrapassado.

(Herdado de Component)

evento

Name Description
Disposed
Obsoleto.

Ocorre quando o componente é eliminado por uma chamada ao Dispose() método.

(Herdado de Component)

Implementações de Interface Explícita

Name 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.
IDbCommand.CreateParameter()
Obsoleto.

Cria uma nova instância de um IDbDataParameter objeto.

(Herdado de DbCommand)
IDbCommand.ExecuteReader()
Obsoleto.

Executa o CommandText contra o Connection e constrói um IDataReader.
IDbCommand.ExecuteReader()
Obsoleto.

Executa o CommandText contra o Connection e constrói um IDataReader.

(Herdado de DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)
Obsoleto.

Executa o CommandText contra o Connection, e constrói um IDataReader usando um dos CommandBehavior valores.
IDbCommand.ExecuteReader(CommandBehavior)
Obsoleto.

Executa o CommandText contra o Connection, e constrói um IDataReader usando um dos CommandBehavior valores.

(Herdado de DbCommand)
IDbCommand.Parameters
Obsoleto.

Obtém o IDataParameterCollection.

(Herdado de DbCommand)
IDbCommand.Transaction
Obsoleto.

Obtém ou define o DbTransaction dentro do qual este DbCommand objeto executa.

(Herdado de DbCommand)

Aplica-se a

Ver também