ActiveConnection 属性 (ADO)

项目
05/30/2023

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

设置和返回值

如果连接关闭，则设置或返回包含连接定义的 String 值；如果连接打开，则设置或返回包含当前 Connection 对象的 Variant。默认值为 null 对象引用。设置 ConnectionString 属性。

备注

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

命令

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

如果在将此属性设置为打开的 Connection 对象或有效的连接字符串之前尝试调用 Command 对象的 Execute 方法，则会发生错误。

如果将 Connection 对象分配给 ActiveConnection 属性，则必须打开该对象。分配关闭的 Connection 对象会导致错误。

注意

若 Microsoft Visual Basic 将 ActiveConnection 属性设置为“无”，则会取消 Command 对象与当前 Connection 的关联，并导致提供程序释放数据源上的任何关联资源。然后，可以将 Command 对象与同一个或另一个 Connection 对象相关联。利用某些提供程序，可以将属性设置从一个 Connection 更改为另一个，而无需先将属性设置为“无”。

如果 Command 对象的 Parameters 集合包含由提供程序提供的参数，那么将 ActiveConnection 属性设置为“无”或另一个 Connection 对象时，会清除该集合。如果手动创建 Parameter 对象并使用它们填充 Command 对象的 Parameters 集合，则将 ActiveConnection 属性设置为“无”或另一个 Connection 对象会使 Parameters 集合保持不变。

如果关闭与 Command 对象关联的 Connection 对象，这会将 ActiveConnection 属性设置为“无”。将此属性设置为关闭的 Connection 对象会生成错误。

记录集

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

可以将此属性设置为有效的 Connection 对象或有效的连接字符串。在这种情况下，提供程序将使用此定义创建新的 Connection 对象，并打开连接。此外，提供程序可将此属性设置为新的 Connection 对象，以便你可访问 Connection 对象来获取详细的错误信息或执行其他命令。

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

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

注意

“远程数据服务使用情况”在客户端 Recordset 对象上使用时，此属性只能设置为连接字符串或（在 Microsoft Visual Basic 或 Visual Basic、Scripting Edition 中）“无”。

记录

此属性在 Record 对象关闭时为可读/写属性，并且可能包含连接字符串或对打开的 Connection 对象的引用。此属性在 Record 对象打开时为只读属性，并且包含对打开的 Connection 对象的引用。

当从 URL 打开 Record 对象时，会隐式创建 Connection 对象。通过将该 Connection 对象分配给此属性，或在 Open 方法调用中使用 Connection 对象作为参数，可以使用现有的已打开的 Connection 对象打开 Record。如果是从现有 Record 或 Recordset 中打开 Record，它将自动与该 Record 或 Recordset 对象的 Connection 对象相关联。

注意

使用 http 方案的 URL 将自动调用用于 Internet 发布的 Microsoft OLE DB 提供程序。有关详细信息，请参阅绝对 URL 和相对 URL。