ActiveConnection 属性 (ADO)
指示指定的 Command、Recordset或当前属于 Record 对象的 Connection 对象。
设置和返回值
设置或返回一个 字符串 值,该值包含连接(如果连接已关闭)或包含当前 连接 对象的 Variant(如果连接处于打开状态)。 默认值为 null 对象引用。 请参阅 ConnectionString 属性。
言论
使用 ActiveConnection 属性可确定将对其执行指定 Command 对象的 连接 对象,或者打开指定的 Recordset。
命令
对于 Command 对象,ActiveConnection 属性是可读/写的。
如果在将此属性设置为打开 连接 对象或有效的连接字符串之前,尝试对 Command 对象调用 Execute 方法,则会发生错误。
如果将 Connection 对象分配给 ActiveConnection 属性,则必须打开该对象。 分配已关闭的连接对象会导致错误。
注意
Microsoft visual Basic 将 ActiveConnection 属性设置为 Nothing 将 Command 对象与当前 连接 取消关联,并导致提供程序释放数据源上的任何关联资源。 然后,可以将 Command 对象与同一个或另一个 Connection 对象相关联。 某些提供程序允许将属性设置从一个 连接 更改为另一个连接,而无需首先将属性设置为 Nothing。
如果 Command 对象的 Parameters 集合包含提供程序提供的参数,如果将 ActiveConnection 属性设置为 Nothing 或其他 Connection 对象,则会清除该集合。 如果手动创建 参数 对象,并使用这些对象填充 Command 对象的 Parameters 集合,将 ActiveConnection 属性设置为 Nothing 或其他 Connection 对象会使 Parameters 集合保持不变。
关闭与 Command 对象关联的 Connection 对象会将 ActiveConnection 属性设置为 Nothing。 将此属性设置为关闭的 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 中,脚本版)设置为 无。
记录
当关闭 Record 对象时,此属性是可读/写的,并且可能包含对打开 连接 对象的连接字符串或引用。 当 Record 对象打开并且包含对打开 Connection 对象的引用时,此属性为只读。
从 URL 打开 Record 对象时,隐式创建 Connection 对象。 使用现有、打开 Connection 对象打开 记录,方法是将 Connection 对象分配给此属性,或使用 Connection 对象作为 Open 方法调用中的参数。 如果从现有 Record 或 Recordset打开 Record,则它将自动与该 Record 或 Recordset 对象的 Connection 对象相关联。
注意
使用 http 方案的 URL 将自动调用 Microsoft OLE DB Provider for Internet Publishing。 有关详细信息,请参阅 绝对 URL 和相对 URL。
适用于
另请参阅
ActiveConnection、CommandText、CommandTimeout、CommandType、Size 和 Direction 属性示例 (VB)
ActiveConnection、CommandText、CommandTimeout、CommandType、Size 和 Direction 属性示例(VC++)
ActiveConnection、CommandText、CommandTimeout、CommandType、Size 和 Direction 属性示例 (JScript)
连接对象 (ADO)
ConnectionString 属性 (ADO)