Свойство ActiveConnection (многомерные объекты ADO)

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

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

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

Комментарии

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

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

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

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

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

Примечание

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

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

"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"  

Применение

Объект Catalog (многомерные объекты ADO)

Объект Cellset (многомерные объекты ADO)

См. также:

Пример объекта Cellset (Visual Basic)
Объект Connection (ADO)
Метод Open (многомерные объекты ADO)