OracleConnection Classe

Referência

Definição

Namespace:: System.Data.OracleClient

Assembly:: System.Data.OracleClient.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Exemplos

O exemplo a seguir cria um OracleCommand e um OracleConnection. O OracleConnection é aberto e definido como a OracleCommand.Connection propriedade . Em seguida, o exemplo chama ExecuteNonQuerye fecha a conexão. Para fazer isso, o ExecuteNonQuery é passado uma cadeia de conexão e uma cadeia de caracteres de consulta que é uma instrução SQL INSERT.

public void InsertRow(string connectionString)
{
    string queryString =
        "INSERT INTO Dept (DeptNo, Dname, Loc) values (50, 'TECHNOLOGY', 'DENVER')";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(queryString);
        command.Connection = connection;
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}

Public Sub InsertRow(ByVal connectionString As String)
    Dim queryString As String = _
      "INSERT INTO Dept (DeptNo, Dname, Loc) values (50, 'TECHNOLOGY', 'DENVER')"

    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(queryString)
        command.Connection = connection
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        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.

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 do computador, do usuário e da empresa. Para saber mais, consulte Segurança.

Observação

Ao contrário do objeto Connection em outros provedores de dados .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 um ChangeDatabase método .

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

Observação

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

Construtores

OracleConnection()	Obsoleto. Inicializa uma nova instância do OracleConnection.
OracleConnection(String)	Obsoleto. Inicializa uma nova instância da classe OracleConnection com a cadeia de conexão especificada.

Propriedades

CanCreateBatch	Obsoleto. Obtém um valor que indica se esta instância DbConnection é compatível com a classe DbBatch. (Herdado de DbConnection)
CanRaiseEvents	Obsoleto. Obtém um valor que indica se o componente pode acionar 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 a conexão antes que a tentativa seja encerrado e um erro seja gerado.
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 o banco de dados a ser usado após uma conexão ser aberta.
DataSource	Obsoleto. Obtém o nome do servidor Oracle ao qual se conectar.
DbProviderFactory	Obsoleto. Obtém o DbProviderFactory para este 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 que estão anexados a este Component. (Herdado de Component)
ServerVersion	Obsoleto. Obtém uma cadeia de caracteres que contém a versão do servidor à qual o cliente está conectado.
Site	Obsoleto. Obtém ou define o ISite do Component. (Herdado de Component)
State	Obsoleto. Obtém o estado atual da conexão.

Métodos

BeginDbTransaction(IsolationLevel)	Obsoleto. Quando substituído em uma classe derivada, inicia uma transação de banco de dados. (Herdado de DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Obsoleto. Inicia de maneira assíncrona 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 IsolationLevel especificado.
BeginTransactionAsync(CancellationToken)	Obsoleto. Inicia de maneira assíncrona uma transação de banco de dados. (Herdado de DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Obsoleto. Inicia de maneira assíncrona uma transação de banco de dados. (Herdado de DbConnection)
ChangeDatabase(String)	Obsoleto. Altera o banco de dados atual para um OracleConnection aberto.
ChangeDatabaseAsync(String, CancellationToken)	Obsoleto. Troca de forma assíncrona o banco de dados atual por uma conexão aberta. (Herdado de DbConnection)
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.
CloseAsync()	Obsoleto. Fecha de maneira assíncrona a conexão com o banco de dados. (Herdado de DbConnection)
CreateBatch()	Obsoleto. Retorna uma nova instância da classe do provedor que implementa a classe DbBatch . (Herdado de DbConnection)
CreateCommand()	Obsoleto. Cria e retorna um objeto OracleCommand associado ao OracleConnection.
CreateDbBatch()	Obsoleto. Quando substituído em uma classe derivada, retorna uma nova instância da classe do provedor que implementa a DbBatch classe . (Herdado de DbConnection)
CreateDbCommand()	Obsoleto. Quando substituído em uma classe derivada, cria e retorna um objeto DbCommand 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()	Obsoleto. Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. (Herdado de DbConnection)
Dispose(Boolean)	Obsoleto. Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados. (Herdado de Component)
Dispose(Boolean)	Obsoleto. Libera os recursos não gerenciados usados pelo DbConnection e opcionalmente libera os recursos gerenciados. (Herdado de DbConnection)
DisposeAsync()	Obsoleto. Descarta de forma assíncrona o objeto da conexão. (Herdado de DbConnection)
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 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 ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetSchema()	Obsoleto. Retorna informações de esquema para a fonte de dados deste OracleConnection.
GetSchema(String)	Obsoleto. Retorna informações de esquema para a fonte de dados deste OracleConnection usando a cadeia de caracteres especificada para o nome do esquema.
GetSchema(String, String[])	Obsoleto. Retorna informações de esquema para a fonte de dados desse 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.
GetSchemaAsync(CancellationToken)	Obsoleto. Essa é uma versão assíncrona de GetSchema(). Provedores devem substituir com uma implementação apropriada. Opcionalmente, o `cancellationToken` pode ser respeitado. A implementação padrão invoca a chamada GetSchema() síncrona e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se já tiver passado um `cancellationToken` cancelado. Exceções geradas por GetSchema() serão comunicadas por meio da propriedade Exceção de Tarefa retornada. (Herdado de DbConnection)
GetSchemaAsync(String, CancellationToken)	Obsoleto. Essa é a versão assíncrona de GetSchema(String). Provedores devem substituir com uma implementação apropriada. Opcionalmente, o `cancellationToken` pode ser respeitado. A implementação padrão invoca a chamada GetSchema(String) síncrona e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se já tiver passado um `cancellationToken` cancelado. Exceções geradas por GetSchema(String) serão comunicadas por meio da propriedade Exceção de Tarefa retornada. (Herdado de DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Obsoleto. Essa é a versão assíncrona de GetSchema(String, String[]). Provedores devem substituir com uma implementação apropriada. Opcionalmente, o `cancellationToken` pode ser respeitado. A implementação padrão invoca a chamada GetSchema(String, String[]) síncrona e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se já tiver passado um `cancellationToken` cancelado. Exceções geradas por GetSchema(String, String[]) serão comunicadas por meio da propriedade Exceção de Tarefa retornada. (Herdado de DbConnection)
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()	Obsoleto. 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)
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 pela ConnectionString.
OpenAsync()	Obsoleto. Uma versão assíncrona de Open(), que abre uma conexão de banco de dados com as configurações especificadas pelo ConnectionString. Esse método invoca o método virtual OpenAsync(CancellationToken) com CancellationToken.None. (Herdado de DbConnection)
OpenAsync(CancellationToken)	Obsoleto. Essa é a versão assíncrona de Open(). Provedores devem substituir com uma implementação apropriada. Opcionalmente, o token de cancelamento pode ser respeitado. A implementação padrão invoca a chamada Open() síncrona e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se já tiver passado um cancellationToken cancelado. Exceções geradas por Open serão comunicadas por meio da propriedade Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do objeto `DbConnection` até a Tarefa retornada ser 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

Disposed	Obsoleto. Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component)
InfoMessage	Obsoleto. Ocorre quando a 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

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 IsolationLevel especificado.
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 objeto DbCommand associado à conexão atual. (Herdado de DbConnection)

Aplica-se a

Partilhar via