Partilhar via


Propriedade ActiveConnection (ADO MD)

Indica a qual objeto ADO Connection o conjunto de células ou 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 objeto connection. O padrão está vazio.

Observações

Você pode definir essa propriedade como um objeto connection do ADO válido ou para uma cadeia de conexão válida. Quando essa propriedade é definida como uma cadeia 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.

Definir a propriedade ActiveConnection de um objeto Catalog para Nothing libera os dados associados, incluindo dados na coleção CubeDefs e qualquer de Dimensãorelacionada, hierarquia de, de nível dee objetos de membro. Fechar um objeto Connection que foi usado para abrir uma do Catálogo de tem o mesmo efeito que definir a propriedade ActiveConnection como Nothing.

Alterar o banco de dados padrão da conexão referenciada pela propriedade ActiveConnection de um objeto do Catálogo de invalida o conteúdo do catálogo .

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

Nota

No Visual Basic, lembre-se de usar a palavra-chave Definir 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 como o caminho completo como . 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 cadeia de caracteres a seguir se conecta a um arquivo de cubo local no local C:\MSDASDK\samples\oledb\olap\data\bobsvid.cub:

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

Aplica-se a

do objeto Cellset (ADO MD)

Consulte Também

exemplo de conjunto de células (VB)
do objeto de conexão (ADO)
método Open (ADO MD)