OracleConnection Classe

Definição

Aviso

Esta API agora é obsoleta.

Representa uma conexão aberta com um banco de dados.Represents an open connection to a database. Essa classe não pode ser herdada.This class cannot be inherited.

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

Exemplos

O exemplo a seguir cria um OracleCommand e um OracleConnection.The following example creates an OracleCommand and an OracleConnection. O OracleConnection é aberto e definido como a propriedade OracleCommand.Connection.The OracleConnection is opened and set as the OracleCommand.Connection property. Em seguida, o exemplo chama ExecuteNonQuerye fecha a conexão.The example then calls ExecuteNonQuery, and closes the connection. Para fazer isso, a ExecuteNonQuery é passada uma cadeia de conexão e uma cadeia de caracteres de consulta que é uma instrução SQL INSERT.To accomplish this, the ExecuteNonQuery is passed a connection string and a query string that is an SQL INSERT statement.

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.This type is deprecated and will be removed in a future version of the .NET Framework. Para obter mais informações, consulte Oracle e ADO.net.For more information, see Oracle and ADO.NET.

Um objeto OracleConnection representa uma conexão exclusiva com um banco de dados Oracle.An OracleConnection object represents a unique connection to an Oracle database. No caso de um sistema de banco de dados cliente/servidor, ele é equivalente a uma conexão de rede com o servidor.In the case of a client/server database system, it is equivalent to a network connection to the server.

Um aplicativo que cria uma instância do objeto OracleConnection pode definir as demandas de segurança declarativas ou imperativas que exigem que todos os chamadores diretos e indiretos tenham a permissão adequada para o código.An application that creates an instance of the OracleConnection object can set declarative or imperative security demands that require all direct and indirect callers to have adequate permission to the code. OracleConnection cria demandas de segurança usando o objeto OraclePermission.OracleConnection creates security demands by using the OraclePermission object. Os usuários podem verificar se o código tem permissões adequadas usando o objeto OraclePermissionAttribute.Users can verify that their code has adequate permissions by using the OraclePermissionAttribute object. Os usuários e os administradores também podem usar a ferramenta de política de segurança de acesso do código (Caspol. exe) para modificar a política de segurança nos níveis de máquina, usuário e empresa.Users and administrators can also use the Code Access Security Policy Tool (Caspol.exe) to modify security policy at the machine, user, and enterprise levels. Para obter mais informações, consulte Segurança.For more information, see Security.

Observação

Ao contrário do objeto de conexão nos outros provedores de dados de .NET Framework (SQL Server, OLE DB e ODBC), o OracleConnection não oferece suporte a uma propriedade de ConnectionTimeout.Unlike the Connection object in the other .NET Framework data providers (SQL Server, OLE DB, and ODBC), OracleConnection does not support a ConnectionTimeout property. Definir um tempo limite de conexão como uma propriedade ou na cadeia de conexão não tem nenhum efeito e o valor retornado é sempre zero.Setting a connection time-out either as a property or in the connection string has no effect, and the value returned is always zero. o OracleConnection também não dá suporte a uma propriedade Database ou a um método ChangeDatabase.OracleConnection also does not support a Database property or a ChangeDatabase method.

Se o objeto OracleConnection sair do escopo, ele permanecerá aberto.If the OracleConnection object goes out of scope, it remains open. Portanto, você deve sempre fechar OracleConnection objetos chamando Close ou Dispose, ou usando o objeto OracleConnection dentro de uma instrução Using.Therefore, you should always close OracleConnection objects by calling Close or Dispose, or by using the OracleConnection object within a Using statement. Caso contrário, a coleta de lixo pode não liberá-las imediatamente.Otherwise, the garbage collection might not free them immediately. Esses atrasos poderão causar erros se o número máximo de conexões for atingido enquanto um número de conexões estiver aguardando para ser excluído pelo coletor de lixo.Such delays can cause errors if the maximum number of connections is reached while a number of connections are waiting to be deleted by the garbage collector. 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.By contrast, closing the connections by calling Close uses native resources more efficiently, enhancing scalability and improving overall application performance. Para garantir que as conexões sempre sejam fechadas, abra a conexão dentro de um bloco de Using.To ensure that connections are always closed, open the connection inside of a Using block.

Observação

Para implantar aplicativos de alto desempenho, você geralmente precisa usar o pool de conexões.To deploy high-performance applications, you often need to use connection pooling. No entanto, quando você usa o .NET Framework Provedor de Dados para Oracle, não é necessário habilitar o pool de conexões porque o provedor o gerencia automaticamente.However, when you use the .NET Framework Data Provider for Oracle, you do not need to enable connection pooling because the provider manages this automatically.

Construtores

OracleConnection()

Inicializa uma nova instância do OracleConnection.Initializes a new instance of the OracleConnection.

OracleConnection(String)

Inicializa uma nova instância da classe OracleConnection com a cadeia de conexão especificada.Initializes a new instance of the OracleConnection class with the specified connection string.

Propriedades

CanRaiseEvents

Obtém um valor que indica se o componente pode acionar um evento.Gets a value indicating whether the component can raise an event.

(Herdado de Component)
ConnectionString

Obtém ou define a cadeia de caracteres usada para abrir um banco de dados Oracle.Gets or sets the string used to open an Oracle database.

ConnectionTimeout

Obtém o tempo de espera para estabelecer a conexão antes que a tentativa seja encerrado e um erro seja gerado.Gets the time to wait to establish a connection before terminating the attempt and generating an error.

Container

Obtém o IContainer que contém o Component.Gets the IContainer that contains the Component.

(Herdado de Component)
Database

Obtém o nome do banco de dados atual ou o banco de dados a ser usado após uma conexão ser aberta.Gets the name of the current database or the database to be used after a connection is opened.

DataSource

Obtém o nome do servidor Oracle ao qual se conectar.Gets the name of the Oracle server to which to connect.

DbProviderFactory

Obtém o DbProviderFactory para este DbConnection.Gets the DbProviderFactory for this DbConnection.

(Herdado de DbConnection)
DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.Gets a value that indicates whether the Component is currently in design mode.

(Herdado de Component)
Events

Obtém a lista de manipuladores de eventos que estão anexados a este Component.Gets the list of event handlers that are attached to this Component.

(Herdado de Component)
ServerVersion

Obtém uma cadeia de caracteres que contém a versão do servidor à qual o cliente está conectado.Gets a string containing the version of the server to which the client is connected.

Site

Obtém ou define o ISite do Component.Gets or sets the ISite of the Component.

(Herdado de Component)
State

Obtém o estado atual da conexão.Gets the current state of the connection.

Métodos

BeginDbTransaction(IsolationLevel)

Quando substituído em uma classe derivada, inicia uma transação de banco de dados.When overridden in a derived class, starts a database transaction.

(Herdado de DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)

Inicia de maneira assíncrona uma transação de banco de dados.Asynchronously starts a database transaction.

(Herdado de DbConnection)
BeginTransaction()

Inicia uma transação no banco de dados.Begins a transaction at the database.

BeginTransaction(IsolationLevel)

Inicia uma transação no banco de dados com o valor IsolationLevel especificado.Begins a transaction at the database with the specified IsolationLevel value.

BeginTransactionAsync(CancellationToken)

Inicia de maneira assíncrona uma transação de banco de dados.Asynchronously begins a database transaction.

(Herdado de DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)

Inicia de maneira assíncrona uma transação de banco de dados.Asynchronously begins a database transaction.

(Herdado de DbConnection)
ChangeDatabase(String)

Altera o banco de dados atual para um OracleConnection aberto.Changes the current database for an open OracleConnection.

ChangeDatabaseAsync(String, CancellationToken)

Troca de forma assíncrona o banco de dados atual por uma conexão aberta.Asynchronously changes the current database for an open connection.

(Herdado de DbConnection)
ClearAllPools()

Esvazia o pool de conexões.Empties the connection pool.

ClearPool(OracleConnection)

Esvazia o pool de conexões associado à conexão especificada.Empties the connection pool associated with the specified connection.

Close()

Fecha a conexão com o banco de dados.Closes the connection to the database.

CloseAsync()

Fecha de maneira assíncrona a conexão com o banco de dados.Asynchronously closes the connection to the database.

(Herdado de DbConnection)
CreateCommand()

Cria e retorna um objeto OracleCommand associado ao OracleConnection.Creates and returns an OracleCommand object associated with the OracleConnection.

CreateDbCommand()

Quando substituído em uma classe derivada, cria e retorna um objeto DbCommand associado à conexão atual.When overridden in a derived class, creates and returns a DbCommand object associated with the current connection.

(Herdado de DbConnection)
CreateObjRef(Type)

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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Herdado de MarshalByRefObject)
Dispose()

Libera todos os recursos usados pelo Component.Releases all resources used by the Component.

(Herdado de Component)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo Component e, opcionalmente, libera os recursos gerenciados.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Herdado de Component)
DisposeAsync()

Descarta de forma assíncrona o objeto da conexão.Asynchronously diposes the connection object.

(Herdado de DbConnection)
EnlistDistributedTransaction(ITransaction)

Inscreve-se na transação especificada como uma transação distribuída.Enlists in the specified transaction as a distributed transaction.

EnlistTransaction(Transaction)

Inscreve-se na transação especificada como uma transação distribuída.Enlists in the specified transaction as a distributed transaction.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
GetSchema()

Retorna informações de esquema para a fonte de dados deste OracleConnection.Returns schema information for the data source of this OracleConnection.

GetSchema(String)

Retorna informações de esquema para a fonte de dados deste OracleConnection usando a cadeia de caracteres especificada para o nome do esquema.Returns schema information for the data source of this OracleConnection using the specified string for the schema name.

GetSchema(String, String[])

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.Returns schema information for the data source of this OracleConnection using the specified string for the schema name and the specified string array for the restriction values.

GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.Returns an object that represents a service provided by the Component or by its Container.

(Herdado de Component)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Herdado de MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

Gera o StateChange evento.Raises the StateChange event.

(Herdado de DbConnection)
Open()

Abre uma conexão com um banco de dados com as configurações de propriedade especificadas pela ConnectionString.Opens a connection to a database with the property settings specified by the ConnectionString.

OpenAsync()

Uma versão assíncrona de Open(), que abre uma conexão de banco de dados com as configurações especificadas pelo ConnectionString.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Esse método invoca o método virtual OpenAsync(CancellationToken) com CancellationToken.None.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

(Herdado de DbConnection)
OpenAsync(CancellationToken)

Essa é a versão assíncrona de Open().This is the asynchronous version of Open(). Provedores devem substituir com uma implementação apropriada.Providers should override with an appropriate implementation. Opcionalmente, o token de cancelamento pode ser respeitado.The cancellation token can optionally be honored.

A implementação padrão invoca a chamada Open() síncrona e retorna uma tarefa concluída.The default implementation invokes the synchronous Open() call and returns a completed task. A implementação padrão retornará uma tarefa cancelada se já tiver passado um cancellationToken cancelado.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Exceções geradas por Open serão comunicadas por meio da propriedade Exceção de Tarefa retornada.Exceptions thrown by Open will be communicated via the returned Task Exception property.

Não invoque outros métodos e propriedades do objeto DbConnection até a Tarefa retornada ser concluída.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

(Herdado de DbConnection)
ToString()

Retorna um String que contém o nome do Component, se houver.Returns a String containing the name of the Component, if any. Esse método não deve ser substituído.This method should not be overridden.

(Herdado de Component)

Eventos

Disposed

Ocorre quando o componente é disposto por uma chamada para o método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Herdado de Component)
InfoMessage

Ocorre quando a Oracle envia um aviso ou uma mensagem informativa.Occurs when Oracle sends a warning or an informational message.

StateChange

Ocorre quando o estado da conexão é alterado.Occurs when the state of the connection changes.

Implantações explícitas de interface

ICloneable.Clone()

Cria um novo objeto que é uma cópia da instância atual.Creates a new object that is a copy of the current instance.

IDbConnection.BeginTransaction()

Inicia uma transação de banco de dados.Begins a database transaction.

IDbConnection.BeginTransaction(IsolationLevel)

Inicia uma transação de banco de dados com o valor IsolationLevel especificado.Begins a database transaction with the specified IsolationLevel value.

IDbConnection.ChangeDatabase(String)

Altera o banco de dados atual para um objeto Connection aberto.Changes the current database for an open Connection object.

IDbConnection.CreateCommand()

Cria e retorna um objeto Command associado à conexão.Creates and returns a Command object that is associated with the connection.

Aplica-se a

Veja também