Compartilhar via

OracleConnection Classe

Definição

Namespace:
System.Data.OracleClient
Assembly:
System.Data.OracleClient.dll

Cuidado

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

Representa uma conexão aberta com um banco de dados. Essa classe não pode ser herdada.

public ref class OracleConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection
public ref class OracleConnection sealed : System::Data::Common::DbConnection, ICloneable
public sealed class OracleConnection : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbConnection
public sealed class OracleConnection : System.Data.Common.DbConnection, ICloneable
[System.Obsolete("OracleConnection has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleConnection : System.Data.Common.DbConnection, ICloneable
type OracleConnection = class
    inherit Component
    interface ICloneable
    interface IDbConnection
    interface IDisposable
type OracleConnection = class
    inherit DbConnection
    interface ICloneable
[<System.Obsolete("OracleConnection has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleConnection = class
    inherit DbConnection
    interface ICloneable
Public NotInheritable Class OracleConnection
Inherits Component
Implements ICloneable, IDbConnection, IDisposable
Public NotInheritable Class OracleConnection
Inherits DbConnection
Implements ICloneable
Herança
Object
MarshalByRefObject
Component
OracleConnection
Herança
Object
MarshalByRefObject
Component
DbConnection
OracleConnection
Atributos
ObsoleteAttribute
Implementações
IDbConnection ICloneable IDisposable

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.

Um OracleConnection objeto representa uma conexão exclusiva com um banco de dados Oracle. No caso de um sistema de banco de dados cliente/servidor, ele é equivalente a uma conexão de rede com o servidor.

Um aplicativo que cria uma instância do OracleConnection objeto pode definir demandas de segurança declarativas ou imperativas que exigem que todos os chamadores diretos e indiretos tenham permissão adequada para o código. OracleConnection cria demandas de segurança usando o OraclePermission objeto. Os usuários podem verificar se seu código tem permissões adequadas usando o OraclePermissionAttribute objeto. Usuários e administradores também podem usar a Ferramenta de Política de Segurança de Acesso ao Código (Caspol.exe) para modificar a política de segurança nos níveis de máquina, usuário e empresa. Para obter mais informações, consulte Segurança.

Observação

Ao contrário do objeto Connection em outros provedores de dados do .NET Framework (SQL Server, OLE DB e ODBC), OracleConnection não há suporte para uma ConnectionTimeout propriedade. Definir um tempo limite de conexão como uma propriedade ou na cadeia de conexão não tem efeito e o valor retornado é sempre zero. OracleConnection também não dá suporte a uma Database propriedade ou a um ChangeDatabase método.

Se o OracleConnection objeto sair do escopo, ele permanecerá aberto. Portanto, você sempre deve fechar OracleConnection objetos chamando ou descartandoClose ou usando o OracleConnection objeto dentro de uma Using instrução. Caso contrário, a coleta de lixo poderá não liberá-las imediatamente. Esses atrasos poderão causar erros se o número máximo de conexões for atingido enquanto várias conexões estão esperando para serem excluídas pelo coletor de lixo. Por outro lado, fechar as conexões chamando Close usa recursos nativos com mais eficiência, aprimorando a escalabilidade e melhorando o desempenho geral do aplicativo. Para garantir que as conexões estejam sempre fechadas, abra a conexão dentro de um Using bloco.

Observação

Para implantar aplicativos de alto desempenho, você geralmente precisa usar o pool de conexões. No entanto, ao usar o Provedor de Dados do .NET Framework para Oracle, você não precisa habilitar o pool de conexões porque o provedor gerencia isso automaticamente.

Construtores

Nome Description
OracleConnection()
Obsoleto.

Inicializa uma nova instância do OracleConnection.
OracleConnection(String)
Obsoleto.

Inicializa uma nova instância da OracleConnection classe com a cadeia de conexão especificada.

Propriedades

Nome Description
CanRaiseEvents
Obsoleto.

Obtém um valor que indica se o componente pode gerar um evento.

(Herdado de Component)
ConnectionString
Obsoleto.

Obtém ou define a cadeia de caracteres usada para abrir um banco de dados Oracle.
ConnectionTimeout
Obsoleto.

Obtém o tempo de espera para estabelecer uma conexão antes de encerrar a tentativa e gerar um erro.
Container
Obsoleto.

Obtém o IContainer que contém o Component.

(Herdado de Component)
Database
Obsoleto.

Obtém o nome do banco de dados atual ou do banco de dados a ser usado depois que uma conexão é aberta.
DataSource
Obsoleto.

Obtém o nome do servidor Oracle ao qual se conectar.
DbProviderFactory
Obsoleto.

Obtém o DbProviderFactory para isso DbConnection.

(Herdado de DbConnection)
DesignMode
Obsoleto.

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

(Herdado de Component)
Events
Obsoleto.

Obtém a lista de manipuladores de eventos anexados a isso Component.

(Herdado de Component)
ServerVersion
Obsoleto.

Obtém uma cadeia de caracteres que contém a versão do servidor ao qual o cliente está conectado.
Site
Obsoleto.

Obtém ou define o ISiteComponent.

(Herdado de Component)
State
Obsoleto.

Obtém o estado atual da conexão.

Métodos

Nome Description
BeginDbTransaction(IsolationLevel)
Obsoleto.

Quando substituído em uma classe derivada, inicia uma transação de banco de dados.

(Herdado de DbConnection)
BeginTransaction()
Obsoleto.

Inicia uma transação no banco de dados.
BeginTransaction(IsolationLevel)
Obsoleto.

Inicia uma transação no banco de dados com o valor especificado IsolationLevel .
ChangeDatabase(String)
Obsoleto.

Altera o banco de dados atual para um aberto OracleConnection.
ClearAllPools()
Obsoleto.

Esvazia o pool de conexões.
ClearPool(OracleConnection)
Obsoleto.

Esvazia o pool de conexões associado à conexão especificada.
Close()
Obsoleto.

Fecha a conexão com o banco de dados.
CreateCommand()
Obsoleto.

Cria e retorna um OracleCommand objeto associado ao OracleConnection.
CreateDbCommand()
Obsoleto.

Quando substituído em uma classe derivada, cria e retorna um DbCommand objeto associado à conexão atual.

(Herdado de DbConnection)
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)
Dispose()
Obsoleto.

Libera todos os recursos usados pelo Component.

(Herdado de Component)
Dispose(Boolean)
Obsoleto.

Libera os recursos não gerenciados usados pelo Component e, opcionalmente, libera os recursos gerenciados.

(Herdado de Component)
EnlistDistributedTransaction(ITransaction)
Obsoleto.

Inscrição na transação especificada como uma transação distribuída.
EnlistTransaction(Transaction)
Obsoleto.

Inscrição na transação especificada como uma transação distribuída.
Equals(Object)
Obsoleto.

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()
Obsoleto.

Serve como a função de hash padrão.

(Herdado de Object)
GetLifetimeService()
Obsoleto.

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

Retorna informações de esquema para a fonte de dados deste OracleConnection.
GetSchema(String, String[])
Obsoleto.

Retorna informações de esquema para a fonte de dados disso OracleConnection usando a cadeia de caracteres especificada para o nome do esquema e a matriz de cadeia de caracteres especificada para os valores de restrição.
GetSchema(String)
Obsoleto.

Retorna informações de esquema para a fonte de dados disso OracleConnection usando a cadeia de caracteres especificada para o nome do esquema.
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()
Obsoleto.

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

Aciona o evento StateChange.

(Herdado de DbConnection)
Open()
Obsoleto.

Abre uma conexão com um banco de dados com as configurações de propriedade especificadas pelo ConnectionString.
OpenAsync()
Obsoleto.

Uma versão assíncrona de , que abre uma conexão de banco de Open()dados com as configurações especificadas pelo ConnectionString. Esse método invoca o método OpenAsync(CancellationToken) virtual com CancellationToken.None.

(Herdado de DbConnection)
OpenAsync(CancellationToken)
Obsoleto.

Esta é a versão assíncrona de Open(). Os provedores devem substituir com uma implementação apropriada. Opcionalmente, o token de cancelamento pode ser respeitado.

A implementação padrão invoca a chamada síncrona Open() e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se aprovada um cancelamento já canceladoToken. As exceções geradas pelo Open serão comunicadas por meio da propriedade de Exceção de Tarefa retornada.

Não invoque outros métodos e propriedades do DbConnection objeto até que a Tarefa retornada seja concluída.

(Herdado de DbConnection)
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)
InfoMessage
Obsoleto.

Ocorre quando o Oracle envia um aviso ou uma mensagem informativa.
StateChange
Obsoleto.

Ocorre quando o estado da conexão é alterado.
StateChange
Obsoleto.

Ocorre quando o estado da conexão é alterado.

(Herdado de DbConnection)

Implantações explícitas de interface

Nome Description
ICloneable.Clone()
Obsoleto.

Cria um novo objeto que é uma cópia da instância atual.
IDbConnection.BeginTransaction()
Obsoleto.

Inicia uma transação de banco de dados.
IDbConnection.BeginTransaction()
Obsoleto.

Inicia uma transação de banco de dados.

(Herdado de DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)
Obsoleto.

Inicia uma transação de banco de dados com o valor especificado IsolationLevel .
IDbConnection.BeginTransaction(IsolationLevel)
Obsoleto.

Inicia uma transação de banco de dados com o nível de isolamento especificado.

(Herdado de DbConnection)
IDbConnection.ChangeDatabase(String)
Obsoleto.

Altera o banco de dados atual para um objeto Connection aberto.
IDbConnection.CreateCommand()
Obsoleto.

Cria e retorna um objeto Command associado à conexão.
IDbConnection.CreateCommand()
Obsoleto.

Cria e retorna um DbCommand objeto associado à conexão atual.

(Herdado de DbConnection)

Aplica-se a

Confira também