OleDbConnection Classe

Definição

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 seguinte cria um OleDbCommand e um OleDbConnection. O OleDbConnection é aberto e definido como o Connection para o OleDbCommand. O exemplo então chama ExecuteNonQuery e fecha a ligação. Para isso, ExecuteNonQuery recebe uma cadeia de ligação e uma string 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

Observações

Um OleDbConnection objeto representa uma ligação única a uma fonte de dados. Num sistema de base de dados cliente/servidor, é equivalente a uma ligação de rede ao servidor. Dependendo da funcionalidade suportada pelo fornecedor nativo de OLE DB, alguns métodos ou propriedades de um OleDbConnection objeto podem não estar disponíveis.

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

Pode abrir mais do que um DataReader num único OleDbConnection. Se o fornecedor OLE DB que utiliza não suportar mais do que um DataReader numa única ligação, o fornecedor abre implicitamente uma ligação adicional para cada uma.

Se sair OleDbConnection do âmbito, não está fechado. Portanto, deve fechar explicitamente a ligação chamando Close ou Dispose, ou usando o OleDbConnection objeto dentro de uma Using instrução.

Se um OleDbException fatal (por exemplo, um nível de gravidade SQL Server de 20 ou superior) for gerado pelo método que executa um OleDbCommand, o OleDbConnection pode estar fechado. No entanto, o utilizador pode reabrir a ligação e continuar.

Uma aplicação 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 exigências de segurança declarativas ou imperativas. OleDbConnection faz exigências de segurança usando o OleDbPermission objeto. Os utilizadores podem verificar se o seu código tem permissões suficientes usando o OleDbPermissionAttribute objeto. Utilizadores e administradores também podem usar o Caspol.exe (Ferramenta de Política de Segurança de Acesso ao Código) para modificar políticas de segurança ao nível do computador, utilizador e empresa. Para obter mais informações, consulte Segurança de acesso ao código e ADO.NET.

Para mais informações sobre o tratamento de mensagens de aviso e informativas do servidor de dados, consulte Eventos de Ligação.

Ver também

• Ligação a Fontes de Dados