Propriedade ActiveConnection (ADO)

Aplica-se ao: Access 2013, Office 2013

Indica a qual objeto Connection pertence o objeto Command, Recordset ou Record.

Configurações e valores retornados

Configura ou retorna um valor String contendo uma definição para uma conexão, caso a conexão esteja fechada, ou um Variant contendo o objeto Connection atual no caso de a conexão estar aberta. O padrão é uma referência nula ao objeto. Consulte também a propriedade ConnectionString.

Comentários

Use a propriedade ActiveConnection para determinar o objeto Connection no qual o objeto Command especificado será executado ou o objeto Recordset especificado será aberto.

Comando

Para os objetos Command, a propriedade ActiveConnection é leitura/gravação.

Ocorrerá um erro se você tentar chamar o método Execute em um objeto Command antes de configurar essa propriedade como um objeto Connection aberto ou uma sequência de conexão válida.

Microsoft Visual Basic: definir a propriedade ActiveConnection como Nothing desassocia o objeto Command da Conexão atual e faz com que o provedor libere todos os recursos associados na fonte de dados. Assim, você pode associar o objeto Command ao mesmo objeto Connection ou a um outro. Alguns provedores permitem que você mude a definição da propriedade de Connection para outro sem precisar antes definir a propriedade como Nothing.

Se a coleção Parameters do objeto Command contiver parâmetros fornecidos pelo provedor, a coleção será limpa se você definir a propriedade ActiveConnection como Nothing ou como outro objeto Connection. Se você criar manualmente objetos Parameter e usá-los para preencher a coleção Parameters do objeto Command, a configuração da propriedade ActiveConnection como Nothing ou como um outro objeto Connection não afetará a coleção Parameters.

O fechamento de um objeto Connection ao qual um objeto Command está associado define a propriedade ActiveConnection como Nothing. A definição dessa propriedade para um objeto Connection fechado gera um erro.

Conjunto de Registros

Para objetos Recordset abertos ou para objetos Recordset cuja propriedade Source esteja definida como um objeto Command válido, a propriedade ActiveConnection é somente leitura. Caso contrário, ela é leitura/gravação.

Você pode definir essa propriedade como um objeto Connection válido ou como uma sequência de conexão válida. Neste caso, o provedor cria um novo objeto Connection usando essa definição e abre a conexão. Além disso, o provedor pode definir essa propriedade para o novo objeto Connection de modo que você acesse o objeto Connection para obter informações de erro estendidas ou execute outros comandos.

Se você usar o argumento ActiveConnection do método Open para abrir um objeto Recordset, a propriedade ActiveConnection herdará o valor do argumento.

Se você configurar a propriedade Source do objeto Recordset como uma variável de objeto Command válida, a propriedade ActiveConnection do Recordset herdará a definição da propriedade ActiveConnection do objeto Command.

Uso do Serviço de Dados Remotos: quando usada em um objeto Recordset do lado do cliente, essa propriedade pode ser definida apenas como um cadeia de conexão ou (no Microsoft Visual Basic ou Visual Basic, Scripting Edition) como Nothing.

Gravar

Essa propriedade é leitura/gravação quando o objeto Record estiver fechado, podendo conter uma sequência de conexão ou referência a um objeto Connection aberto. Ela é somente leitura quando o objeto Record estiver aberto e contiver uma referência a um objeto Connection aberto.

Um objeto Connection é criado implicitamente quando o objeto Record é aberto a partir de uma URL. Abra o Record com um objeto Connection existente e aberto atribuindo o objeto Connection a essa propriedade ou usando o objeto Connection como um parâmetro na chamada do método Open. Se o Registro for aberto de um Registro ou Recordset existente, ele será associado automaticamente ao objeto Connection desse objeto Record ou Recordset.