Propriedade ActiveConnection (ADO MD)

Aplica-se ao: Access 2013, Office 2013

Indica a que objeto Connection do ADO pertence o conjunto de células ou o catálogo atual.

Configurações e valores retornados

Define ou retorna um objeto Variant que contém uma cadeia de caracteres que define uma conexão ou um objeto Connection. O padrão é vazio.

Comentários

Você pode definir esta propriedade como um objeto Connection válido do ADO ou como um cadeia de caracteres de conexão válida. Quando essa propriedade é definida como uma cadeia de caracteres de conexão, o provedor cria um novo objeto Connection usando essa definição e abre a conexão.

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

A definição da propriedade ActiveConnection de um objeto Catalog como Nothing libera os dados associados, incluindo os dados da coleção CubeDefs e os objetos Dimension, Hierarchy, Level e Member relacionados. O fechamento do objeto Connection usado para abrir um Catalog tem o mesmo efeito que a definição da propriedade ActiveConnection como Nothing.

A alteração do banco de dados padrão da conexão referenciada pela propriedade ActiveConnection de um objeto Catalog invalida o conteúdo do Catalog.

Ocorrerá um erro se você tentar alterar a propriedade ActiveConnection de um objeto Cellset aberto.

Observação

[!OBSERVAçãO] No Visual Basic, lembre-se de usar a palavra-chave Set ao definir a propriedade ActiveConnection como um objeto Connection. Se você omitir a palavra-chave Set, estará realmente definindo a propriedade ActiveConnection de forma equivalente à propriedade padrão do objeto Connection, ConnectionString. O código funcionará; contudo, você criará uma conexão adicional à fonte de dados, que poderá ter implicações de desempenho negativas.

Ao usar o provedor de dados MSOLAP, defina a fonte de dados em uma cadeia de caracteres de conexão como o nome de um servidor e defina o catálogo inicial como o nome de um catálogo da fonte de dados. Para se conectar a um arquivo de cubo que esteja desconectado de um servidor, defina o local como o caminho completo para o arquivo .CUB. Nesse caso, defina o provedor com o respectivo nome. Por exemplo, a cadeia de caracteres a seguir conecta-se a um catálogo chamado Bobs Video Store em um servidor chamado Servername com o Provedor MSOLAP:

"Data Source=Servername;Initial Catalog=Bobs Video Store;Provider=msolap"

A cadeia de caracteres a seguir conecta-se a um arquivo de cubo local em C:\MSDASDK\samples\oledb\olap\data\bobsvid.cub:

"Location=C:\MSDASDK\samples\oledb\olap\data\bobsvid.cub;Provider=msolap"