OracleConnection Classe

Definição

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

Atenção

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

Representa uma ligação aberta a uma base de dados. Esta 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

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.

Um OracleConnection objeto representa uma ligação única a uma base de dados Oracle. No caso de um sistema de base de dados cliente/servidor, é equivalente a uma ligação de rede ao servidor.

Uma aplicação que cria uma instância do OracleConnection objeto pode definir exigências de segurança declarativas ou imperativas que exigem que todos os chamadas diretas e indiretas tenham permissão adequada para o código. OracleConnection cria exigências de segurança ao usar o OraclePermission objeto. Os utilizadores podem verificar se o seu código tem permissões adequadas usando o OraclePermissionAttribute objeto. Utilizadores e administradores podem também usar a Ferramenta de Política de Segurança de Acesso ao Código (Caspol.exe) para modificar políticas de segurança ao nível da máquina, utilizador e empresa. Para obter mais informações, consulte Security.

Note

Ao contrário do objeto Connection nos outros fornecedores de dados do .NET Framework (SQL Server, OLE DB e ODBC), OracleConnection não suporta uma propriedade ConnectionTimeout. Definir um time-out de ligação, seja como propriedade ou na cadeia de ligação, não tem efeito, e o valor devolvido é sempre zero. OracleConnection Também não suporta uma Database propriedade ou um ChangeDatabase método.

Se o OracleConnection objeto sair do âmbito de alcance, permanece aberto. Por isso, deve sempre fechar OracleConnection objetos chamando Close ou Dispose, ou usando o OracleConnection objeto dentro de uma Using instrução. Caso contrário, a recolha de lixo pode não os libertar imediatamente. Tais atrasos podem causar erros se o número máximo de ligações for atingido enquanto várias ligações estão à espera de serem eliminadas pelo coletor de lixo. Em contraste, fechar as ligações ao chamar Close utiliza recursos nativos de forma mais eficiente, melhorando a escalabilidade e o desempenho global da aplicação. Para garantir que as ligações estão sempre fechadas, abra a ligação dentro de um Using bloco.

Note

Para implementar aplicações de alto desempenho, muitas vezes é necessário usar pooling de ligações. No entanto, quando utiliza o .NET Framework Data Provider para a Oracle, não precisa de ativar o pooling de ligações porque o fornecedor gere isto automaticamente.

Construtores

Name Description
OracleConnection()
Obsoleto.

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

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

Propriedades

Name 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 usada para abrir uma base de dados Oracle.
ConnectionTimeout
Obsoleto.

Tem tempo para esperar para estabelecer uma ligação antes de terminar 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 da base de dados atual ou da base de dados a ser usada após a abertura de uma ligação.
DataSource
Obsoleto.

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

Recebe o DbProviderFactory por isto DbConnection.

(Herdado de DbConnection)
DesignMode
Obsoleto.

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

(Herdado de Component)
Events
Obsoleto.

Obtém a lista de gestores de eventos que estão ligados a isto Component.

(Herdado de Component)
ServerVersion
Obsoleto.

Obtém uma string contendo a versão do servidor a que o cliente está ligado.
Site
Obsoleto.

Obtém ou define o ISite do Component.

(Herdado de Component)
State
Obsoleto.

Obtém o estado atual da ligação.

Métodos

Name Description
BeginDbTransaction(IsolationLevel)
Obsoleto.

Quando é sobreposto numa classe derivada, inicia uma transação de base de dados.

(Herdado de DbConnection)
BeginTransaction()
Obsoleto.

Inicia uma transação na base de dados.
BeginTransaction(IsolationLevel)
Obsoleto.

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

Altera a base de dados atual para um .OracleConnection
ClearAllPools()
Obsoleto.

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

Esvazia o pool de ligação associado à ligação especificada.
Close()
Obsoleto.

Fecha a ligação à base de dados.
CreateCommand()
Obsoleto.

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

Quando sobreposto numa classe derivada, cria e devolve um DbCommand objeto associado à ligação atual.

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

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

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

Devolve informação de esquema para a fonte de dados deste OracleConnection.
GetSchema(String, String[])
Obsoleto.

Devolve a informação do esquema para a fonte de dados desta OracleConnection usando a cadeia especificada para o nome do esquema e o array de cadeias especificado para os valores de restrição.
GetSchema(String)
Obsoleto.

Devolve a informação do esquema para a fonte de dados desta OracleConnection usando a cadeia especificada para o nome do esquema.
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)
OnStateChange(StateChangeEventArgs)
Obsoleto.

Eleva o StateChange evento.

(Herdado de DbConnection)
Open()
Obsoleto.

Abre uma ligação a uma base de dados com as definições de propriedade especificadas pelo ConnectionString.
OpenAsync()
Obsoleto.

Uma versão assíncrona de Open(), que abre uma ligação à base de dados com as definições especificadas pelo ConnectionString. Este 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 prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode ser opcionalmente aceito.

A implementação padrão invoca a chamada síncrona Open() e devolve uma tarefa concluída. A implementação padrão devolverá uma tarefa cancelada se for passada uma cancellationToken já cancelada. As exceções lançadas pelo Open serão comunicadas através da propriedade de Exceção de Tarefa devolvida.

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

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

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

Ocorre quando o estado da ligação muda.
StateChange
Obsoleto.

Ocorre quando o estado da ligação muda.

(Herdado de DbConnection)

Implementações de Interface Explícita

Name Description
ICloneable.Clone()
Obsoleto.

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

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

Inicia uma transação de base de dados.

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

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

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

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

Altera a base de dados atual para um objeto Connection aberto.
IDbConnection.CreateCommand()
Obsoleto.

Cria e devolve um objeto Command associado à ligação.
IDbConnection.CreateCommand()
Obsoleto.

Cria e devolve um DbCommand objeto associado à ligação atual.

(Herdado de DbConnection)

Aplica-se a

Ver também