Propriedade ActiveConnection (ADO)

Artigo
05/30/2023

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

Configurações e valores retornados

Define ou retorna um valor String que contém uma definição para uma conexão se a conexão está fechada ou uma Variant que contém o objeto Connection atual se a conexão está aberta. O padrão é uma referência de objeto nula. Confira a propriedade ConnectionString.

Comentários

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

Comando

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

Se você tentar chamar o método Execute em um objeto Command antes de definir essa propriedade como um objeto Connection aberto ou uma cadeia de conexão válida, ocorrerá um erro.

Se um objeto Connection for atribuído à propriedade ActiveConnection, o objeto precisará ser aberto. A atribuição de um objeto Connection fechado causa um erro.

Observação

Microsoft Visual Basic A definição da propriedade ActiveConnection como Nothing desassocia o objeto Command da Connection atual e faz com que o provedor libere todos os recursos associados na fonte de dados. Em seguida, você pode associar o objeto Command ao mesmo ou a outro objeto Connection. Alguns provedores permitem que você altere a configuração de propriedade de uma Connection para outra, sem precisar primeiro definir a propriedade como Nothing.

Se a coleção Parameters do objeto Command contiver parâmetros fornecidos pelo provedor, a coleção será desmarcada 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 definição da propriedade ActiveConnection como Nothing ou como outro objeto Connection deixará a coleção Parameters intacta.

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

Conjunto de registros

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

Defina essa propriedade como um objeto Connection válido ou como uma cadeia de conexão válida. Nesse caso, o provedor cria um objeto Connection usando essa definição e abre a conexão. Além disso, o provedor pode definir essa propriedade como o novo objeto Connection para dar a você uma forma de acessar o objeto Connection a fim de obter informações de erro estendidas ou executar 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ê definir a propriedade Source do objeto Recordset como uma variável de objeto Command válida, a propriedade ActiveConnection do Recordset herdará a configuração da propriedade ActiveConnection do objeto Command.

Observação

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

Record

Essa propriedade é leitura/gravação quando o objeto Record está fechado e pode conter uma cadeia de conexão ou uma referência a um objeto Connection aberto. Essa propriedade é somente leitura quando o objeto Record está aberto e contém uma referência a um objeto Connection aberto.

Um objeto Connection é criado implicitamente quando o objeto Record é aberto por meio 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 de método Open. Se o Record for aberto de um Record ou um Recordset existente, ele será automaticamente associado ao objeto Connection desse objeto Record ou Recordset.