Objeto Connection (ADO)

Aplica-se ao: Access 2013, Office 2013

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

Comentários

Um objeto Connection representa uma única sessão com uma fonte de dados. No caso de um sistema de banco de dados cliente/servidor, pode ser equivalente à conexão de rede real com o servidor. Dependendo da funcionalidade suportada pelo provedor, algumas coleções, métodos ou propriedades de um objeto Connection podem não estar disponíveis.

Com as coleções, os métodos e as propriedades de um objeto Connection, você pode fazer o seguinte:

• Configurar a conexão antes de abri-la com as propriedades ConnectionString, ConnectionTimeout e Mode. ConnectionString é a propriedade padrão de um objeto Connection.

• Definir a propriedade CursorLocation para o cliente chamar o Microsoft Cursor Service for OLE DB, que suporta as atualizações em lotes.

• Definir o banco de dados padrão da conexão com a propriedade DefaultDatabase.

• Definir o nível de isolamento das transações abertas na conexão com a propriedade IsolationLevel.

• Especificar um provedor do OLE DB com a propriedade Provider.

• Estabelecer, e mais tarde quebrar, a conexão física da fonte de dados com os métodos Open e Close.

• Executar um comando na conexão com o método Execute e configurar a execução com a propriedade CommandTimeout.

  Observação

  [!OBSERVAçãO] Para executar uma consulta sem usar o objeto Command, passe uma sequência de consulta para o método Execute de um objeto Connection. No entanto, um objeto Command será necessário quando você desejar insistir no texto de comando e reexecutá-lo ou usar os parâmetros da consulta.

• Gerenciar as transações na conexão aberta, incluindo as transações aninhadas se o provedor oferecer suporte para essas transações, com o métodos BeginTrans, CommitTrans e RollbackTrans e a propriedade Attributes.

• Examinar os erros retornados da fonte de dados com a coleção Errors.

• Ler a versão da implementação ADO usada com a propriedade Version.

• Obter informações sobre o esquema do banco de dados com o método OpenSchema.

Crie os objetos Connection independentemente de qualquer outro objeto definido anteriormente.

Execute os comandos ou procedimentos armazenados como se fossem métodos nativos no objeto Connection, como exemplificado a seguir.

Executar um comando como um método nativo de um objeto Connection

Para executar um comando, forneça o nome dele usando o objeto Command da propriedade Name. Defina a propriedade ActiveConnection do objeto Command para a conexão. Em seguida, emita uma instrução na qual o nome do comando será usado como se fosse um método do objeto Connection, seguido por quaisquer parâmetros e depois por um objeto Recordset se quaisquer linhas forem retornadas. Defina as propriedades Recordset para personalizar o Recordset resultante. Por exemplo:

    Dim cnn As New ADODB.Connection
    Dim cmd As New ADODB.Command
    Dim rst As New ADODB.Recordset
    ...
    cnn.Open "..."
    cmd.Name = "yourCommandName"
    cmd.ActiveConnection = cnn
    ...
    'Your command name, any parameters, and an optional Recordset.
    cnn.yourCommandName "parameter", rst

Executar um procedimento armazenado com um método nativo do objeto Connection

Para executar um procedimento armazenado, emita uma instrução na qual o nome do procedimento armazenado seja usado como se fosse um método do objeto Connection, seguido por quaisquer parâmetros. O ADO se tornará a "melhor solução" dos tipos de parâmetros. Por exemplo:

    Dim cnn As New ADODB.Connection
    ...
    'Your stored procedure name and any parameters.
    cnn.sp_yourStoredProcedureName "parameter"