Propriedade ActiveConnection (ADO MD)

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

Configurações e valores retornados

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

Comentários

Você pode definir essa propriedade como um objeto ADO Connection válido ou como uma cadeia de conexão válida. Quando essa propriedade é definida como uma cadeia de conexão, o provedor cria um 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 na coleção CubeDefs e os objetos Dimension, Hierarchy, Level e Member relacionados. O fechamento de um 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 para um objeto Cellset aberto.

Observação

Em Visual Basic, lembre-se de usar a palavra-chave Set ao definir a propriedade ActiveConnection para um objeto Connection. Se você omitir a palavra-chave Set, você realmente definirá a propriedade ActiveConnection igual à propriedade padrão do objeto Connection, ConnectionString. O código funcionará. No entanto, você criará uma conexão adicional com a fonte de dados, o que pode ter implicações negativas no desempenho.

Ao usar o provedor de dados MSOLAP, defina a fonte de dados em uma cadeia de conexão como um nome de 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 desconectado de um servidor, defina o local para o caminho completo como o arquivo .CUB. Em ambos os casos, defina o provedor como o nome do provedor. Por exemplo, a cadeia de caracteres a seguir usa o Provedor MSOLAP para se conectar a um catálogo chamado Bobs Video Store em um servidor chamado Servername:

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

A seguinte cadeia de caracteres se conecta a um arquivo de cubo local na localização C:\MSDASDK\samples\oledb\olap\data\bobsvid.cub:

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

Aplica-se A

Objeto Catalog (ADO MD)

Objeto Cellset (ADO MD)

Consulte Também

Exemplo de conjunto de células (VB)
Objeto Connection (ADO)
Método Open (ADO MD)