指示指定的 Command 或 Recordset 对象当前所属的 Connection 对象。

设置和返回值

设置或返回包含了定义连接或 Connection 对象的字符串。默认情况下为 Null 对象引用。

说明

使用 ActiveConnection 属性可确定在其上将执行指定 Command 对象或打开指定 Recordset 的 Connection 对象。

命令

对于 Command 对象，ActiveConnection 属性为读/写。

在将该属性设置为打开的 Connection 对象或有效连接字符串之前，试图调用 Command 对象的 Execute 方法将产生错误。

Microsoft Visual Basic   将 ActiveConnection 属性设置为 Nothing 可使 Command 对象与当前 Connection 脱离关联，并使提供者释放数据源上所有关联的资源。然后，可以使 Command 对象与相同的 Connection 对象或其他 Connection 对象关联。某些提供者允许将该属性设置从一个 Connection 更改到另一个 Connection，而不必首先将该属性设置为 Nothing。

如果 Command 对象的 Parameter 集合包含提供者提供的参数，那么假如将 ActiveConnection 属性设置为 Nothing 或设置为其他 Connection 对象，将清除集合。如果手工创建 Parameter 对象并使用这些参数填充 Command 对象的 Parameters 集合，则将 ActiveConnection 属性设置为 Nothing 或其他 Connection 对象不会影响 Parameters 集合。

关闭与 Command 对象相关联的 Connection 对象将把 ActiveConnection 属性设置为 Nothing。将该属性设置为已关闭的 Connection 对象将产生错误。

Recordset

对于打开的 Recordset 对象或其 Source 属性被设置为有效 Command 对象的 Recordset 对象，ActiveConnection 属性为只读。否则，该属性为读/写。

可以将该属性设置为有效的 Connection 对象，或设置为有效的连接字符串。这时，提供者可使用该定义创建新的 Connection 对象，并打开连接。另外，提供者可以将该属性设置为新的 Connection 对象，以便向您提供访问扩展错误信息的 Connection 对象或执行其他命令。

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

如果将 Recordset 对象的 Source 属性设置为有效 Command 对象变量，Recordset 的 ActiveConnection 属性将继承 Command 对象的 ActiveConnection 属性的设置。

远程数据服务用法   在客户端 (ADOR) Recordset 对象上使用时，只能将该属性设置为连接字符串或（Microsoft Visual Basic 或 VBScript 中）Nothing