ADO三大对象的属性方法事件及常数(三)

1、ADO三大对象的属性、方法、事件及常数三Recordset 对象属性属性名称数据类型和用途AbsolutePage可读写Long类型，要么是设置或返回当前记录所处的页面序号，要么是一个PositionEnum常数，见AbsolutePage用到的常数。在获取或设置 AbsolutePage的值之前，必 须先设定PageSize的值。AbsolutePage是从1开始计数的。如果当前记录位于第一页时，AbsolutePage的返回值为1，对AbsolutePage设置将使当前记录指针指向指定页的第一条记 录。个人收集整理勿做商业用途AbsolutePosition*可读写的Long类型从1开始计

2、数，设置或返回当前记录年处的位置。AbsolutePosition的最大取值是 RecordCount属性的值。个人收集整理勿做商业用途ActiveComma nd 可读写的Stri ng类型，Recordset所关联的先前翻开的Comma nd对象名称 个人收集整理勿做商业用途ActiveCo nn ecti on 指针类型，指向 Recordset所关联的先前翻开的 Conn ection对象，或指向 一条完整有效的 ConnectionString串值。个人收集整理勿做商业用途BOF*只读Boolean类型，假设为True，说明记录指针已位于Recordset第一条记录之前，并且没有了当

3、前记录个人收集整理 勿做商业用途Bookmark*可读写Variant类型，返回对特定记录的引用或使用一个Bookmark值使记录指针指向特定记录 个人收集整理勿做商业用途CacheSize*可读写Long类型，指定本地 Cache中所存的记录条数，最小 默认值为1。假设 增加了 CacheSize的值，那么在流动 Recordset以获取更多记录时，能减少与效劳器的通信次 数。个人收集整理勿做商业用途CursorLocation可读写Long类型，指定可流动游标的位置，即 CursorType是位于客户端还 是位于效劳器端，见CursorLocation用到的常数。默认值是使用OLE DB数

4、据源提供的游标。 个人收集整理勿做商业用途CusrsorType*可读写Long类型，指定 Recordset游标的类型，见 CursorType用到的常数， 默认值是forward-only游标个人收集整理勿做商业用途DataMember 指针类型，指向关联的DataEnvironment.Command 对象DataSource 指针类型，指向关联的DataEnvironment.Connection 对象EditMode* 只读Long类型，返回 Recordset的编辑状态，见 EditMode用到的常数EOF*只读Boolean类型，假设为True，说明记录指针已超出Recordse

5、t的最后一条记录，并且没有了当前记录。个人收集整理 勿做商业用途Filter*可读写Variant类型，要么是一条件表达式一条有效的 SQL WHERE子句但又不出 现保存字 WHERE，要么是指向特定记录的 Bookmark数组，要么是一个 Filter常数，详见 Filter用至U的常数。个人收集整理勿做商业用途LockType*可读写Long类型，指定翻开 Recordset所使用的记录锁定方法。默认值是只读， 对应于forward-only游标的只读特性。见 LockType属性用到的常数。个人收集整理勿做商业用途MarshalOptions可读写Long类型，指定客户端改动后，应返回

6、哪个记录集合，此属性仅适 合于不常见的 ADOR.Recordset对象，此对象是 对象成员之一。 个人 收集整理勿做商业用途MaxRecords*可读写Long类型，指定SELECT查询或存储过程返回的最大记录条数，默认值为0,即全部返回个人收集整理勿做商业用途PageCount只读Long类型，返回Recordset所有的页数，必须设定了 PageSize的值，PageCount的返回值才是真正有意义的。如果Recordset不支持PageCount属性，那么返回值为-1个人收集整理勿做商业用途PageSize可读写Long类型，设置或返回一个逻辑页所包含的记录条数。使用逻辑页可把大的Re

7、cordset分解为多个易处理的小局部。通常的做法是把PageSize设为 DataGrid、MsFlexGrid或层次型的FlexGrid控件所能显示的记录条数。 PageSize和锁定Jet(2k)或锁定SQL Server(6.5版及更早版本，2k;7.0版，8k)数据库时用到的表页面大小无关个人收集整理勿做商业用途PersistFormat可读写Long类型，设置或返回由调用 Save方法所创立的 Recordset文件的格 式。当前仅有一个值 adPersistADTG(默认格式：Advaneed Data TableGram)个人收集整理勿做 商业用途RecordCount*只读L

8、ong类型，如果 Recordset支持近似定位或支持书签，那么返回带可流动 游标的Recordset所含有的记录数；如果不支持，必须使用MoveLast方法以取得确实覆盖了所有记录的准确的RecordCount数值。如果 forward-only类型 Recordset有一条或多条记录，Recordset返回-1(True),任何类型的空的 Recordset都将返回O(False)个人收集整理 勿做商业 用途Sort*可读写String类型，包含一条不含保存字ORDER BY的SQL ORDERY BY 子句，用以指定Recordset的排序方式个人收集整理勿做商业用途Source*可读写

9、Stri ng类型，可以是SQL语句、表名、存储过程名或相关 Comma nd对象名。 如果提供了 Comma nd对象名，那么 Source将返回 Comma nd.Comma ndText的值。利用 Ope n 方法的参数IngOptions可以指定提供应 Source值的类型 个人收集整理勿做商业用途State可读写Long类型，为对象状态常数之一。见State常数Status只读Long类型，说明对 Recordset进行批处理或其他多记录 (bulk)操作后的状态。见Status属性用到的常数个人收集整理 勿做商业用途注意：上表所列属性是ADODB.Recordset对象的标准属性，

10、即那些被关系数据库的大多数通用 OLE DB数据提供者所支持的属性。带星号的属性表示它与DAO.Recordset或rdoResultset对象的相应属性完全一样或很接近。个人收集整理勿做商业用途方法 方法用途AddNew* 向可更新的 Recordset添加一条新记录。调用语法为 rstName.AddNewvarField|avarFields,varValue|avarValuese, 其中 varField 是单个字段名， avarFields是字段名数组。varValue是单个字段值，avarValue是由avarFields指定字段的值所组成的数组。调用 Update方法那么把新记

11、录加到数据库的表中。如果向主关键字不是第一 个字段的Recordset中添加记录，那么必须在AddNew方法中指定主关键字的名称和值个人收集整理勿做商业用途Cancel取消异步查询的执行，中止存储过程或复合SQL语句创立多个 Recordset，调用语法为rstName.Cancel个人收集整理 勿做商业用途CancelBatch*取消LockEdit值为BatchOptimistic的Recordset的即将生效的批量更新操作， 调用语法为：rstName.CancelBatch IngAffectRecords,可选参数 IngAffectRecords 的取值见 lngAffectRec

12、ords用到的常数个人收集整理勿做商业用途Clone复制一个带有独立记录指针 的 Recordset对象，调用语法为：Set rstDupe=rstName.Clone()个人收集整理勿做商业用途Close关闭Recordset对象，以后可以重新设Recordset的属性并使用 Open方法来再度访问Recordset。调用语法为：rstName.Close个人收集整理勿做商业用途Delete* 如果 Recordset 的 LockEdit 属性值未设为 adLockBatchOptimistic，立刻从 Recordset 和相应表中删除当前记录 个人收集整理勿做商业用途Find寻找满足指

13、定条件的记录。调用语法为：rstName.Find strCriteria ,lngSkipRecords,IngSearchDirection ,lngStart,其中 strCriteria 是不含 WHERE 关键字的 SQL WHERE 子句， 可选参数lngSkipRecords是应用 Find前所跳过的记录数目，lngDirection 指定查找方向adSearchForward,和 adSearchBackward,其中 adSearchForward 是默认值,可选参数 IngStart 指 定了从哪儿开始查找，其值要么是一个Bookmark值，要么是 Bookmark常数，见

14、varStart参数用到的Bookmark常数。个人收集整理勿做商业用途GetRows 返回一个二维 Varia nt数组行、列，调用语法为 avar name=rstName.GetRowsl ngRows,varStart,strFieldName|lngFieldIndex|avarFieldNames|avarFieldlndexes,其中 lngRows 是返 回记录行数，varStart指定从哪儿开始查找，其值要么是一个 Bookmark值，要么是Bookmark常数，见varStart参数用到的Bookmark常数。第三个参数可以是单个列字段的名称或 索引，也可以是多个列名称或索

15、引组成的Variant数组。如果不指定第三个参数，GetRows返回Recordset中所有列。个人收集整理勿做商业用途GetString默认情况下，返回指定数目记录的String串值，记录间由返回代码分隔。记录内由 tab 分隔。 调用语法为：strClip=rst name.GetStri ngln gRows,strCloumnDelimiter,strRowDelimiter,strNullExpr。其中 IngRows 为返回记录行数，strColumnDelimiter为可选的列分隔符vbTab是默认值,strRowDelimiter是可选的行分隔符 vbCr是默认值，strNul

16、lExpr是可选参数，用于碰到Null值时的替代值默认值是空字符串。GetString的主要用途是通过把控件的Clip属性设为strClip来处理 MSFIexGrid 或MSHFlexGrid 控件个人收集整理勿做商业用途Move*从当前记录移动记录指针。调用语法为：rstName.Move IngNumRecords , varStart,其中IngNumRecords是要跳过的记录数，可选选参数varStart指定从哪开始移动。其值要么是一个 Bookmark值，要么是 Bookmark常数，见varStart参数用到的 Bookmark常数。 个人 收集整理勿做商业用途MoveFirs

17、t*移动记录指针到第一条记录，调用语法为：rstName.MoveFirstMoveLast*移动记录指针到最后一条记录，调用语法为：rstName.MoveLastMoveNext移动记录指针到下一条记录，调用语法为：rstName.MoveNext。它是能用于forward-only Recordset的唯一 Move方法个人收集整理勿做商业用途MovePrevious*移动记录指针到前一条记录，调用语法为：rstName.MovePrevious个人收集整理勿做商业用途NextRecordset返回另外的 Recordset,它通常由能产生多个Recordset的复合 SQL语句如SEL

18、ECT * FROM orders;SELECT * FROM customers或存储过程来创立。调用语法为 Next=rstName.NextRecordset IngRecordsAffected,其中可选参数 IngRecordsAffected 指定返 回到rstNext中去的记录数目。如果已不存在Recordset， rstNext被设为Nothing个人收集整理勿做商业用途Ope n在一个活动Comma nd 或 Conn ection 对象上翻开一个Recordset，调用语法为：rstName.Ope n varSource , varActiveC onnection, I

19、n gCursorType , In gLockType ,IngOptions。这些参数都是可选的，个人收集整理勿做商业用途Requery重新从表中获取 Recordset的内容，等效于 Close后再Open。它是一个资源集中型 操作。语法为：rstName.Requery个人收集整理勿做商业用途Resync* 重新从表中获取局部 Recordset 内容。调用语法为 rstName.Resync IngAffectRecords, 其中IngAffectRecords的取值见IngAffectRecords 用到的常数。如果把该参数设为 adAffectCurrent或adAffectG

20、roup，那么比adAffectAII默认值所耗的资源要少。个人收集整理 勿做商业用途Save创立包含 Recordset永久性拷贝的文件。调用语法为rstName.Save strFileName。其中strFileName为路径和文件名。通常用.rst作为文件的扩展名。个人收集整理 勿做商业用途Supports如果数据提供者支持指定的游标相关的方法，那么返回True，否那么返回为False。调用语法为 Supported=rstname.Supports IngCursorOptions.关于 IngCursorOptions,见 Supports 方法用至曲勺常数。 个人收集整理勿做商业

21、用途Update*使对Recordset的修改对底层数据源中的表生效。对于批量操作，Update方法只使修改对本地CachedRecordset生效。调用语法为 rstName.Update个人收集整理勿做商业用途UpdateBatch* 合对指量类型的RecordsetLockType 属性值为 adBatchOptimistic,CursorType属性值为adOpenKeyset或adOpenStatic所做的修改对底层数据源中的表生效。调用语法为 rstName.UpdateBatch lngAfectRecords,其中 lngAffectRecords 的取值见 IngAffect

22、records 用到 的常数。个人收集整理勿做商业用途注：ADODB.Recordset对象不支持 Edit方法。为了改变 ADODB.Recordset对象当前记录的 一个或多个字段的值，可以先使用rstName.Fieldsn.Value=varValue把相应字段的值改为所需要的值，而后执行 rstName.Update即可。个人收集整理勿做商业用途事件事件名称触发时机EndOfRecordset记录指针试图移到最后一条记录之外时FieldchangeComplete字段值的改变完成之后 MoveComplete Move 或 Move.方法执行之后 RecordsCha ngeComp

23、lete对单个记录编辑完成以后 RecordsetCha ngeComplete缓存中的改变对底层表生效之后 WillCha ngField对字段值改变之前WillChangeRecord对单个记录改变之前WillChangeRecordset缓存中的改变对底层表生效之前WillMove Move或Move.方法执行之前adReason参数。该参数的取值见 adReason参数用Recordset为空，或数据提供者不能确定页码。BOF属性值为TrueEOF属性值为True注：事件处理模块的函数头几乎都用到了至曲勺常数。 个人收集整理 勿做商业用途 常数AbsolutePage属性用到的常数常数

24、含义adPosUnknown数据提供者不支持页面, adPosBOF记录指针定位于文件开头 adPosEOF记录指针定位于文件结尾CursorLocation属性用到的常数常数含义adUseClient使用客户端游标库提供的游标。ADODB.Recordset要求客户端游标adUseServer使用数据源提供的游标，通常但非绝对位于效劳器上默认值 CursorType属性用到的常数常数含义adOpenForwardonly提供单向移动游标和只读Recordset 默认值adOpenDynamic提供可滚动游标，可显示其他用户对Recordset所做的改动包括添加新记录个人收集整理勿做商业用途d

25、ynaset类型的adOpenKeyset提供可滚动游标，只隐藏其他用户所做的改动，类似于DAO.Recordset个人收集整理勿做商业用途adOpe nStatic提供一个位于Recordset静态拷贝上的可滚动游标，类似于snap shot类型的DAO.Recordset，但多了可更新特性个人收集整理勿做商业用途EditMode属性用到的常数常数含义adEditNone无正在进行的编辑操作默认值 adEditAdd临时添加一条记录，但尚未存入数据库的表中 adEditlnProgress当前记录中的数据已经改动，但尚未存入数据库的表中 Filter属性用到的常数 常数含义adFilterN

26、one除去已有的过滤器，显示Recordset中的所有记录等效于把Filter属性置为空串，默认值个人收集整理勿做商业用途adfilterAffectedRecords 只显示上次 CancelBatch、Delete> Resync或 UpdateBatch 方法执行后 所影响的记录 个人收集整理 勿做商业用途adFilterFetchedRecords只当前 Cache中的记录，记录条数由 CacheSize来确定 个人收集整理 勿 做商业用途adFilterPendingRecords只显示已改动但尚未被数据源处理的记录仅适用于批量更新模式个人收集整理勿做商业用途LockType属

27、性用到的常数常数含义adLockRecordOnly指定只读访问默认值 adLockBatchOptimistic使用批量更新模式而不是默认的立即更新模式adLockOptimistic使用乐观锁仅在更新过程中才锁定记录或页面adLockPessimistic使用悲观锁编辑或更新整个过程中均锁定记录或页面State常数常数含义adStateClosed Connection或其他对象是关闭的默认值adStateCo nn ecti ng正在连接数据源的状态adStateExecuti ng Co nn ection或Comma nd对象的Execute方法已被调用个人收集整理勿做商业用途adS

28、tateFetching 返回行row到 Recordset 对象adStateOpen Connection或其他对象是翻开的活动的Status属性用到的常数仅适用于Batch或Bulk Recordset操作 常数含义adRecOK成功更新adRecNew成功添加adRecModified 成功修改adRecDeleted成功删除adRecUnmodified 无改动adRec In valid未保存：Bookmark属性无效 adRecMultipleChanges未保存：保存会影响其他记录 adRecPe ndi ngCha nges未保存：记录引用了一个等待插入操作 adRecCa

29、nceled未保存：操作被取消 adRecCa ntRelease未保存：现有记录值阻止了保存adRecCo ncurre ncyViolation 未保存：乐观并发锁发生了问题adRec In tegrityViolation 未保存：操作会影响一致性 adRecMaxCha ngesExceeded未保存：存在太多的等待改动 adRecObjectOpe n未保存：翻开存贮对象发生冲突 adRecOutofMemory未保存：内存缺乏 adRecPermissio nDe nied未保存：用户权限不够 adRecSchemaViolation未保存：记录的结构不符合数据库中的定义 adRecDBDeleted未保存或删除：记录已被删除 lngAffectRecords参数用到的常数 Comma nd类型常数含义adAffectAll包括Recordset对象的所有记录