Поделиться через


Свойство ActiveConnection (ADO MD)

Область применения: Access 2013, Office 2013

Указывает, к какому объекту ADO Connection принадлежит текущий набор ячеек или каталог.

Параметры и возвращаемые значения

Задает или возвращает объект Variant , содержащий строку, определяющую соединение или объект Connection . Значение по умолчанию пусто.

Замечания

Для этого свойства можно задать допустимый объект ADO Connection или допустимый строка подключения. Если для этого свойства задано значение строка подключения, поставщик создает новый объект Connection с помощью этого определения и открывает подключение.

Если для открытия объекта Cellset используется аргумент ActiveConnection метода Open, свойство ActiveConnection наследует значение аргумента .

Установка для свойства ActiveConnection объекта Каталога значения Nothing освобождает связанные данные, включая данные в коллекции CubeDefs и все связанные объекты Dimension, Hierarchy, Level и Member . Закрытие объекта Connection , который использовался для открытия каталога , имеет тот же эффект, что и установка для свойства ActiveConnection значения Nothing.

Изменение базы данных по умолчанию подключения, на которое ссылается свойство ActiveConnection объекта Catalog , делает недействительным содержимое каталога.

При попытке изменить свойство ActiveConnection для открытого объекта Cellset возникнет ошибка.

Примечание.

В Visual Basic не забудьте использовать ключевое слово Set при задании свойства ActiveConnection объекта Connection. Если опустить ключевое слово Set, вы фактически задаете свойство ActiveConnection, равное свойству объекта Connection по умолчанию ConnectionString. Код будет работать; однако вы создадите дополнительное подключение к источнику данных, что может отрицательно повлиять на производительность.

При использовании поставщика данных MSOLAP задайте для источника данных в строка подключения имя сервера, а в исходном каталоге — имя каталога из источника данных. Чтобы подключиться к файлу куба, который отключен от сервера, задайте для расположения полный путь к . CUB-файл. В любом случае задайте поставщику имя поставщика. Например, следующая строка подключается к каталогу с именем Bobs Video Store на сервере с именем Servername с поставщиком MSOLAP:

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

Следующая строка подключается к локальному файлу куба в расположении C:\MSDASDK\samples\oledb\olap\data\bobsvid.cub:

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