ActiveConnection 属性 (ADO MD)

适用于:Access 2013、Office 2013

指示当前单元格集或目录当前所属的 ADO Connection 对象。

设置和返回值

设置或返回一个 Variant 值,该值包含定义连接的字符串或包含一个 Connection 对象。 默认值为空。

备注

可将此属性设置为有效的 ADO Connection 对象,或有效的连接字符串。 当此属性设置为连接字符串时,提供程序将使用此定义创建一个新的 Connection 对象,并打开该连接。

如果使用 Open 方法的 ActiveConnection 参数打开 Cellset 对象,则 ActiveConnection 属性将继承该参数的值。

Catalog 对象的 ActiveConnection 属性设置为 Nothing 后,会导致释放关联的数据,包括 CubeDefs 集合以及任何相关的 DimensionHierarchyLevelMember 对象中的数据。 关闭用于打开 CatalogConnection 对象与将 ActiveConnection 属性设置为 Nothing 的效果相同。

更改 Catalog 对象的 ActiveConnection 属性所引用的连接的默认数据库,会使该 Catalog 的内容失效。

如果尝试更改打开的 Cellset 对象的 ActiveConnection 属性,则会发生错误。

注意

[!注释] 在 Visual Basic 中将 ActiveConnection 属性设置为 Connection 对象时,请不要忘记使用 Set 关键字。 如果省略 Set 关键字,您实际上是将 ActiveConnection 属性设置为等于 Connection 对象的默认属性,即 ConnectionString 。 代码会运行;但您将创建另一个指向数据源的连接,而这可能会对性能产生负面影响。

使用 MSOLAP 数据提供程序时,请将连接字符串中的数据源设置为服务器名称,将初始目录设置为该数据源中的目录的名称。 若要连接到某个与服务器断开的多维数据集文件,请将位置设置为该 .CUB 文件的完整路径。 无论在哪种情况下,都应将提供程序设置为提供程序的名称。 例如,下面的字符串使用 MSOLAP 提供程序连接到名为 Servername 的服务器上一个名为 Bobs Video Store 的目录:

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