OleDbConnection Classe

Definição

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacote:

System.Data.OleDb v8.0.0

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

public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable

public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable, IDisposable

type OleDbConnection = class
    inherit DbConnection
    interface ICloneable
    interface IDbConnection
    interface IDisposable

Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDisposable

Herança

Object

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 para o 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 com suporte do 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 do OleDbConnection, todas as propriedades são definidas com 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 sair do escopo, ele não será fechado. Portanto, você deve fechar explicitamente a conexão chamando ou DescartandoClose ou usando o OleDbConnection objeto dentro de uma Using instrução .

Observação

Para implantar aplicativos de alto desempenho, você deve usar o pool de conexões. Ao usar o provedor de dados .NET Framework 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 provedor de dados .NET Framework para OLE DB, consulte OLE DB, ODBC e Oracle Connection Pooling.

Se um fatal OleDbException (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 de segurança declarativas ou imperativas. OleDbConnection faz demandas de segurança usando 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 do computador, do usuário e da 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 mensagens informativas e de aviso do servidor de dados, consulte Eventos de conexão.

Observação

O OleDbConnection objeto não dá suporte à configuração nem à recuperação de propriedades dinâmicas específicas de 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

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

Propriedades

CanCreateBatch	Obtém um valor que indica se esta instância DbConnection é compatível com a classe DbBatch. (Herdado de DbConnection)
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) durante a tentativa de estabelecimento da conexão antes que a tentativa seja terminada e um erro seja gerado.
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.
DataSource	Obtém o nome do servidor ou o nome de arquivo da fonte de dados.
DbProviderFactory	Obtém o DbProviderFactory para este DbConnection. (Herdado de DbConnection)
Provider	Obtém o nome do provedor OLE DB especificado na cláusula "Provider=" da 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.
State	Obtém o estado atual da conexão.

Métodos

BeginDbTransaction(IsolationLevel)	Quando substituído em uma classe derivada, inicia uma transação de banco de dados. (Herdado de DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Inicia de maneira assíncrona uma transação de banco de dados. (Herdado de DbConnection)
BeginTransaction()	Inicia uma transação de banco de dados com o valor IsolationLevel atual.
BeginTransaction(IsolationLevel)	Inicia uma transação de banco de dados com o nível de isolamento especificado.
BeginTransactionAsync(CancellationToken)	Inicia de maneira assíncrona uma transação de banco de dados. (Herdado de DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Inicia de maneira assíncrona uma transação de banco de dados. (Herdado de DbConnection)
ChangeDatabase(String)	Altera o banco de dados atual para um OleDbConnection aberto.
ChangeDatabaseAsync(String, CancellationToken)	Troca de forma assíncrona o banco de dados atual por uma conexão aberta. (Herdado de DbConnection)
Close()	Fecha a conexão com a fonte de dados.
CloseAsync()	Fecha de maneira assíncrona a conexão com o banco de dados. (Herdado de DbConnection)
CreateBatch()	Retorna uma nova instância da classe do provedor que implementa a classe DbBatch . (Herdado de DbConnection)
CreateCommand()	Cria e retorna um objeto OleDbCommand associado ao OleDbConnection.
CreateDbBatch()	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()	Quando substituído em uma classe derivada, cria e retorna um objeto DbCommand associado à conexão atual. (Herdado de DbConnection)
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. (Herdado de DbConnection)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo DbConnection e opcionalmente libera os recursos gerenciados. (Herdado de DbConnection)
DisposeAsync()	Descarta de forma assíncrona o objeto da conexão. (Herdado de DbConnection)
EnlistTransaction(Transaction)	Inscreve-se 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 de hash padrão. (Herdado de Object)
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)	Retorna informações de esquema para a fonte de dados deste OleDbConnection usando a cadeia de caracteres especificada para o nome do esquema.
GetSchema(String, String[])	Retorna informações de esquema para a fonte de dados desse 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.
GetSchemaAsync(CancellationToken)	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)	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)	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)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
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 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)	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)
ReleaseObjectPool()	Indica que o pool de objetos OleDbConnection pode ser liberado quando a última conexão subjacente é liberada.
ResetState()	Atualiza a propriedade State do objeto OleDbConnection.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Eventos

InfoMessage	Ocorre quando o provedor envia um aviso ou uma mensagem informativa.
StateChange	Ocorre quando o estado da conexão é alterado. (Herdado de DbConnection)

Implantações explícitas de interface

ICloneable.Clone()

Para obter uma descrição desse membro, confira Clone().

Confira também

• Conectando-se a fontes de dados