ActiveConnection 属性 (ADO MD)

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

设置和返回值

设置或返回一个变体，其中包含定义连接或 Connection 对象的字符串。 默认为空白。

备注

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

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

将 Catalog 对象的 ActiveConnection 属性设置为 Nothing 会释放关联的数据，包括 CubeDefs 集合中的数据以及任何相关的 Dimension、Hierarchy、Level 和 Member 对象。 关闭用于打开 Catalog 的 Connection 对象与将 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"  

应用于

目录对象 (ADO MD)

单元集对象 (ADO MD)

另请参阅

单元集示例 (VB)
连接对象 (ADO)
Open 方法 (ADO MD)