ADO API 参考( ADO 属性)

AbsolutePage 属性

指定当前记录所在的页。

设置和返回值

设置或返回从 1 到 Recordset 对象 (PageCount) 所含页数的长整型值，或者返回以下常量。

常量	说明
AdPosUnknown	Recordset 为空，当前位置未知，或者提供者不支持 AbsolutePage 属性。
AdPosBOF	当前记录指针位于 BOF（即 BOF 属性为 True）。
AdPosEOF	当前记录指针位于 EOF（即 EOF 属性为 True）。

说明

使用 AbsolutePage 属性可识别当前记录所在的页码。使用 PageSize 属性可将 Recordset 对象逻辑划分为一系列的页，每页的记录数等于 PageSize（最后页除外，该页记录数较少）。提供者必须支持该属性的相应功能才能使用该属性。

与  AbsolutePosition 属性一样，AbsolutePage 从 1 开始并在当前记录为 Recordset 中的第一个记录时等于 1。设置该属性可移动到特定页的第一个记录。从 PageCount 属性中可获得总页数。

AbsolutePosition 属性

指定 Recordset 对象当前记录的序号位置。

设置和返回值

设置或返回从 1 到 Recordset 对象 (PageCount) 所含页数的长整型值，或者返回以下常量。

常量	说明
AdPosUnknown	Recordset 为空，当前位置未知，或者提供者不支持 AbsolutePage 属性。
AdPosBOF	当前记录指针位于 BOF（即 BOF 属性为 True。）
adPosEOF	当前记录指针位于 EOF（即 EOF 属性为 True。）

说明

使用 AbsolutePosition 属性可根据其在 Recordset 中的序号位置移动到记录，或确定当前记录的序号位置。提供者必须支持该属性的相应功能才能使用该属性。

同 AbsolutePage 属性一样，AbsolutePosition 从 1 开始，并在当前记录为 Recordset 中的第一个记录时等于 1。从 RecordCount 属性可获得 Recordset 对象的总记录数。

设置 AbsolutePosition 属性时，即使该属性指向位于当前缓存中的记录，ADO 也将使用以指定的记录开始的新记录组重新加载缓存。CacheSize 属性决定该记录组的大小。

注意   不能将 AbsolutePosition 属性作为替代的记录编号使用。删除前面的记录时，给定记录的当前位置将发生改变。如果 Recordset 对象被重新查询或重新打开，则无法保证给定记录有相同的 AbsolutePosition。书签仍然是保持和返回给定位置的推荐方式，并且在所有类型的 Recordset 对象的定位时是唯一的方式。

ActiveCommand 属性

指示创建关联的 Recordset 对象的 Command 对象。

返回值

返回包含 Command 对象的变体型。默认为 Null 对象引用。

说明

ActiveCommand 属性为只读。

如果没有使用 Command 对象创建当前 Recordset，将返回 Null 对象引用。

如果您只有结果 Recordset 对象，则可使用该属性查找关联的 Command 对象。

ActiveConnection 属性

指示指定的 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

ActualSize 属性

指示字段的值的实际长度。

设置和返回值

返回长整型值。某些提供者允许设置该属性以便为 BLOB 数据预留空间，在此情况下