Propriedade ActiveConnection (ADO)

Artigo
01/19/2017

Indica a qual objeto Connection o de Comandoespecificado, recordsetou Record objeto 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 estiver fechada ou um Variant que contém o objeto conexão atual se a conexão estiver aberta. O padrão é uma referência de objeto nulo. Consulte a propriedade ConnectionString.

Observações

Use a propriedade ActiveConnection para determinar o objeto connection sobre o qual o objeto command especificado será executado ou o de conjunto de registros especificado será aberto.

Comando

Para objetos de Comando, a propriedade ActiveConnection é leitura/gravação.

Se você tentar chamar o método Execute em um objeto de comando 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 deverá ser aberto. Atribuir um objeto Connection fechado causa um erro.

Nota

Microsoft Visual Basic Definindo a propriedade ActiveConnection para Nothing desassocia o objeto de Comando do de Conexão 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 outro objeto Connection. Alguns provedores permitem que você altere a configuração de propriedade de um Connection para outro, 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 para outro objeto de Conexão. Se você criar manualmente objetos Parameter e usá-los para preencher a coleção parâmetros do objeto de comando, definir a propriedade ActiveConnection como Nothing ou para outro objeto Connection deixará a coleção de Parâmetros intacta.

Fechar o objeto de Conexão com o qual um objeto de Comando está associado define a propriedade ActiveConnection como Nothing. Definir essa propriedade como um objeto Connection fechado gera um erro.

Conjunto de registros

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

Você pode definir essa propriedade como um objeto Connection válido ou para uma cadeia de conexão válida. Nesse 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 como o novo objeto Connection para fornecer uma maneira de acessar o objeto Connection para 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 de comando de válida, a propriedade ActiveConnection do Recordset herdará a configuração da propriedade activeConnection do objeto Command.

Nota

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

Registro

Essa propriedade é de leitura/gravação quando o objeto Record é 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 de Registro está aberto e contém uma referência a um objeto de Conexão aberto.

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

Nota

As URLs que usam o esquema http invocarão automaticamente o provedor Microsoft OLE DB para publicação na Internet. Para obter mais informações, consulte URLs absolutas e relativas.