OleDbConnection Classe

Definição

Namespace:
System.Data.OleDb
Assembly:
System.Data.dll

Representa uma conexão aberta com uma fonte de dados.

public ref class OleDbConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection
public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable
public sealed class OleDbConnection : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbConnection
public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable, IDisposable
type OleDbConnection = class
    inherit Component
    interface ICloneable
    interface IDbConnection
    interface IDisposable
type OleDbConnection = class
    inherit DbConnection
    interface ICloneable
    interface IDbConnection
    interface IDisposable
Public NotInheritable Class OleDbConnection
Inherits Component
Implements ICloneable, IDbConnection, IDisposable
Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDisposable
Herança
Object
MarshalByRefObject
Component
OleDbConnection
Herança
Object
MarshalByRefObject
Component
DbConnection
OleDbConnection
Implementações
IDbConnection ICloneable IDisposable

Exemplos

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

public void InsertRow(string connectionString, string insertSQL)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        // The insertSQL string contains a SQL statement that
        // inserts a new row in the source table.
        OleDbCommand command = new OleDbCommand(insertSQL);

        // Set the Connection to the new OleDbConnection.
        command.Connection = connection;

        // Open the connection and execute the insert command.
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
}

Public Sub InsertRow(ByVal connectionString As String, _
    ByVal insertSQL As String)

    Using connection As New OleDbConnection(connectionString)
        ' The insertSQL string contains a SQL statement that
        ' inserts a new row in the source table.
        Dim command As New OleDbCommand(insertSQL)

        ' Set the Connection to the new OleDbConnection.
        command.Connection = connection

        ' Open the connection and execute the insert command.
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

Comentários

Um OleDbConnection objeto representa uma conexão exclusiva com uma fonte de dados. Com um sistema de banco de dados cliente/servidor, ele é equivalente a uma conexão de rede com o servidor. Dependendo da funcionalidade compatível com o provedor OLE DB nativo, alguns métodos ou propriedades de um OleDbConnection objeto podem não estar disponíveis.

Quando você cria uma instância de OleDbConnection, todas as propriedades são definidas como seus valores iniciais. Para obter uma lista desses valores, consulte o OleDbConnection construtor.

Você pode abrir mais de um DataReader em um único OleDbConnection. Se o provedor OLE DB usado não oferecer suporte a mais de um DataReader em uma única conexão, o provedor abrirá implicitamente uma conexão adicional para cada um.

Se o OleDbConnection escopo sair, ele não será fechado. Portanto, você deve fechar explicitamente a conexão chamando Close ou descartando ou usando o OleDbConnection objeto dentro de uma Using instrução.

Note

Para implantar aplicativos de alto desempenho, você deve usar o pool de conexões. Ao usar o .NET Framework Provedor de Dados para OLE DB, você não precisa habilitar o pool de conexões porque o provedor gerencia isso automaticamente. Para obter mais informações sobre como usar o pool de conexões com o .NET Framework Provedor de Dados para OLE DB, consulte OLE DB, ODBC e Oracle Connection Pooling.

Se um OleDbException fatal (por exemplo, um nível de severidade SQL Server de 20 ou mais) for gerado pelo método que executa um OleDbCommand, o OleDbConnection poderá ser fechado. No entanto, o usuário pode reabrir a conexão e continuar.

Um aplicativo que cria uma instância do OleDbConnection objeto pode exigir que todos os chamadores diretos e indiretos tenham permissão suficiente para o código definindo demandas declarativas ou imperativas de segurança. OleDbConnection faz com que as demandas de segurança usem o OleDbPermission objeto. Os usuários podem verificar se seu código tem permissões suficientes usando o OleDbPermissionAttribute objeto. Usuários e administradores também podem usar o Caspol.exe (Ferramenta de Política de Segurança de Acesso ao Código) para modificar a política de segurança nos níveis de computador, usuário e empresa. Para obter mais informações, consulte Segurança de acesso do código e ADO.NET.

Para obter mais informações sobre como lidar com avisos e mensagens informativas do servidor de dados, consulte Eventos de Conexão.

Note

O OleDbConnection objeto não dá suporte à configuração ou à recuperação de propriedades dinâmicas específicas para um provedor OLE DB. Somente as propriedades que podem ser passadas na cadeia de conexão para o provedor OLE DB têm suporte.

Construtores

Nome Description
OleDbConnection()

Inicializa uma nova instância da classe OleDbConnection.
OleDbConnection(String)

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

Propriedades

Nome Description
CanRaiseEvents

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

(Herdado de Component)
ConnectionString

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

Obtém o tempo de espera (em segundos) ao tentar estabelecer uma conexão antes de encerrar a tentativa e gerar um erro.
Container

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

(Herdado de Component)
Database

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

Obtém o nome do servidor ou o nome do arquivo da fonte de dados.
DbProviderFactory

Obtém o DbProviderFactory para isso DbConnection.

(Herdado de DbConnection)
DesignMode

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

(Herdado de Component)
Events

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

(Herdado de Component)
Provider

Obtém o nome do provedor OLE DB especificado na cláusula "Provider=" do cadeia de conexão.
ServerVersion

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

Obtém ou define o ISite do Component.

(Herdado de Component)
State

Obtém o estado atual da conexão.

Métodos

Nome Description
BeginDbTransaction(IsolationLevel)

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

(Herdado de DbConnection)
BeginTransaction()

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

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

Altera o banco de dados atual para um aberto OleDbConnection.
Close()

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

Cria e retorna um OleDbCommand objeto associado ao OleDbConnection.
CreateDbCommand()

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

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

(Herdado de MarshalByRefObject)
Dispose()

Libera todos os recursos usados pelo Component.

(Herdado de Component)
Dispose(Boolean)

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

(Herdado de Component)
EnlistDistributedTransaction(ITransaction)

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

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

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetLifetimeService()

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)
GetOleDbSchemaTable(Guid, Object[])

Retorna informações de esquema de uma fonte de dados, conforme indicado por um GUID, e depois de aplicar as restrições especificadas.
GetSchema()

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

Retorna informações de esquema para a fonte de dados disso OleDbConnection 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)

Retorna informações de esquema para a fonte de dados disso OleDbConnection usando a cadeia de caracteres especificada para o nome do esquema.
GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou por sua Container.

(Herdado de Component)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InitializeLifetimeService()

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

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(Herdado de MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

Aciona o evento StateChange.

(Herdado de DbConnection)
Open()

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

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)

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)
ReleaseObjectPool()

Indica que o OleDbConnection pool de objetos pode ser liberado quando a última conexão subjacente é liberada.
ResetState()

Atualiza a State propriedade do OleDbConnection objeto.
ToString()

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

Ocorre quando o componente é descartado por uma chamada para o Dispose() método.

(Herdado de Component)
InfoMessage

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

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

Ocorre quando o estado da conexão é alterado.

(Herdado de DbConnection)

Implantações explícitas de interface

Nome Description
ICloneable.Clone()

Para obter uma descrição deste membro, consulte Clone().
IDbConnection.BeginTransaction()

Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código.

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

Inicia uma transação de banco de dados.

(Herdado de DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)

Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código.

Inicia uma transação de banco de dados com o nível de isolamento especificado.
IDbConnection.BeginTransaction(IsolationLevel)

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

(Herdado de DbConnection)
IDbConnection.CreateCommand()

Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código.

Cria e retorna um objeto de comando associado à conexão.
IDbConnection.CreateCommand()

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

(Herdado de DbConnection)

Aplica-se a

Confira também