属性AbsolutePage 属性

AbsolutePage属性

AbsolutePage属性

指定当前记录所在的页。

设置和返回值

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

说明

使用AbsolutePage属性可识别当前记录所在的页码。使用PageSize属性可将Recordset对象逻辑划分为一系列的页每页的记录数等于PageSize 最后页除外该页记录数较少 。提供者必须支持该属性的相应功能才能使用该属性。与AbsolutePosition属性一样 AbsolutePage从1开始并在当前记录为Recordset中的第一个记录时等于1。设置该属性可移动到特定页的第一个记录。从PageCount属性中可获得总页数。

AbsolutePosition属性

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

设置和返回值

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

说明

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

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

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

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

ActiveCommand属性

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

返回值

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

说明

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中 NothingActualSize属性

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

设置和返回值

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

说明

使用ActualSize属性可返回Field对象值的实际长度。对于所有字段ActualSize属性为只读。如果ADO无法确定Field对象值的实际长度ActualSize属性将返回adUnknown。

如以下范例所示 ActualSize和Def inedSize属性有所不同 adVarChar声明类型且最大长度为50个字符的Field对象将返回为50的DefinedSize属性值但是返回的ActualSize属性值是当前记录的字段中存储的数据的长度。

Attributes属性

指示对象的一项或多项特性。

设置和返回值

设置或返回长整型值。

对于Connection对象 Attributes属性为读/写并且其值可能为以下任意一个或多个XactAttributeEnum值的和默认为零 。

对于Parameter对象 Attributes属性为读/写并且其值可能为以下任意一个或多个ParameterAttributesEnum值的和。

对于Field对象 Attributes属性为只读其值可能为以下任意一个或多个FieldAttributeEnum值的和。

adFldRowVersion指示该字段包含用来跟踪更新的某种时间或日adFldCacheDeferred 指示提供者缓存了字段值并已完成随后对缓存对于Property对象 Attributes属性为只读并可能是以下任意一个或多个PropertyAttributesEnum值的和

说明

使用Attributes属性可设置或返回Connection对象、Paramete对象、Field对象或Property对象的特性。

设置多个属性时可以将相应的常量相加。如果将属性值设置为包括不兼容常量的总和那么将产生错误。

远程数据服务用法该属性在客户端的Connection对象上无效。

BOF、 EOF属性

 BOF指示当前记录位置位于Recordset对象的第一个记录之前。

 EOF指示当前记录位置位于Recordset对象的最后一个记录之后。返回值

BOF和EOF属性返回布尔型值。

说明

使用BOF和EOF属性可确定Recordset对象是否包含记录或者从一个记录移动到另一个记录时是否超出Recordset对象的限制。

如果当前记录位于第一个记录之前 BOF属性将返回True (-1) 如果当前记录为第一个记录或位于其后则将返回False (0) 。

如果当前记录位于Recordset对象的最后一个记录之后EOF属性将返回True而当前记录为Recordset对象的最后一个记录或位于其前则将返回False。

如果BOF或EOF属性为True则没有当前记录。

如果打开没有记录的Recordset对象 BOF和EOF属性将设置为True而Recordset对象的RecordCount属性设置为零。打开至少包含一条记录的Recordset对象时第一条记录为当前记录而BOF和EOF属性为False。如果删除Recordset对象中保留的最后记录 BOF和EOF属性将保持False直到重新安排当前记录。

以下表格说明不同BOF和EOF属性组合所允许的Move方法。

允许使用Move方法并不能保证该方法成功定位记录只是意味着调用指定的Move方法不会产生错误。

下表说明当调用各种Move方法但未成功定位记录时BOF和EOF属性设置所发生的情况。

Bookmark属性

返回唯一标识Recordset对象中当前记录的书签或者将Recordset对象的当前记录设置为由有效书签所标识的记录。

设置和返回值

设置或返回计算有效书签的变体型表达式。

说明

使用Bookmark属性可保存当前记录的位置并随时返回到该记录。书签只能在支持书签功能的Recordset对象中使用。

打开Recordset对象时其每个记录都有唯一的书签。要保存当前记录的书签请将Bookmark属性的值赋给一个变量。移动到其他记录后要快速返回到该记录请将该Recordset对象的Bookmark属性设置为该变量的值。

用户可能无法查看书签的值也同样无法对书签直接进行比较指向同一记录的两个书签的值可能不同 。

如果使用Clone方法创建Recordset的一个副本则原始的和复制的Recordset对象Bookmark属性设置相同并可以替换使用。但是无法替换使用不同Recordset对象的书签 即使这些书签是通过同一数据源或命令创建的。

远程数据服务用法在客户端(ADOR) Recordset对象上使用时 Bookmark属性始终有效。

CacheSize属性

指示缓存在本地内存中的Recordset对象的记录数。

设置和返回值

设置或返回必须大于0的长整型值。默认值为1。

说明

使用CacheSize属性可控制提供者在缓存中所保存的记录的数目并可控制一次恢复到本地内存的记录数。例如如果CacheSize为10首次打开Recordset对象后提供者将前面10个记录调入本地内存。当在Recordset对象中移动时提供者返回本地内存缓冲区中的数据一旦移动超过缓存中最后的记录提供者便将数据源中随后的10个记录恢复到缓存。

可以在Recordset对象的存活期调整该属性的值但是更改该值只影响随后从数据源调入缓存的记录数。只更改属性值将不会更改缓存中的当前内容。如果要检索的记录较CacheSize指定的少提供者将返回其余的记录不会产生错误。

不允许将CacheSize设置为零否则将返回错误。

从缓存恢复的记录不反映其他用户对数据源同时所作的更改。如需强行对所有缓存数据进行更新请使用Resync方法。

CommandText属性

包含要根据提供者发送的命令的文本。

设置和返回值

设置或返回包含提供者命令如SOL语句、表格名称或存储的过程调用的字符串值。默认值为"" 零长度字符串 。

说明

使用CommandText属性可设置或返回Command对象的文本。通常该属性为SQL语句但也可以是提供者识别的任何其他类型的命令语句如存储的过程调用 。 SQL语句必须是提供者查询处理程序支持的特定语法或版本。如果设置CommandText属性时将Command对象的Prepared属性设置为True并将Command对象绑定到打开的连接则在调用Execute或Open方法时ADO将准备查询即提供者保存已编译的查询格式 。

取决于CommandType属性的设置 ADO可能改变CommandText属性。请随时阅读CommandText属性查看在执行过程中ADO将要使用的实际命令文本。