ADO三大對象的屬性方法事件及常數(shù)(三)

1、ADO三大對象的屬性、方法、事件及常數(shù)三Recordset 對象屬性屬性名稱數(shù)據(jù)類型和用途AbsolutePage可讀寫Long類型，要么是設置或返回當前記錄所處的頁面序號，要么是一個PositionEnum常數(shù)，見AbsolutePage用到的常數(shù)。在獲取或設置 AbsolutePage的值之前，必 須先設定PageSize的值。AbsolutePage是從1開始計數(shù)的。如果當前記錄位于第一頁時，AbsolutePage的返回值為1，對AbsolutePage設置將使當前記錄指針指向指定頁的第一條記 錄。個人收集整理勿做商業(yè)用途AbsolutePosition*可讀寫的Long類型從1開始計

2、數(shù)，設置或返回當前記錄年處的位置。AbsolutePosition的最大取值是 RecordCount屬性的值。個人收集整理勿做商業(yè)用途ActiveComma nd 可讀寫的Stri ng類型，Recordset所關聯(lián)的先前翻開的Comma nd對象名稱 個人收集整理勿做商業(yè)用途ActiveCo nn ecti on 指針類型，指向 Recordset所關聯(lián)的先前翻開的 Conn ection對象，或指向 一條完整有效的 ConnectionString串值。個人收集整理勿做商業(yè)用途BOF*只讀Boolean類型，假設為True，說明記錄指針已位于Recordset第一條記錄之前，并且沒有了當

3、前記錄個人收集整理 勿做商業(yè)用途Bookmark*可讀寫Variant類型，返回對特定記錄的引用或使用一個Bookmark值使記錄指針指向特定記錄 個人收集整理勿做商業(yè)用途CacheSize*可讀寫Long類型，指定本地 Cache中所存的記錄條數(shù)，最小 默認值為1。假設 增加了 CacheSize的值，那么在流動 Recordset以獲取更多記錄時，能減少與效勞器的通信次 數(shù)。個人收集整理勿做商業(yè)用途CursorLocation可讀寫Long類型，指定可流動游標的位置，即 CursorType是位于客戶端還 是位于效勞器端，見CursorLocation用到的常數(shù)。默認值是使用OLE DB數(shù)

4、據(jù)源提供的游標。 個人收集整理勿做商業(yè)用途CusrsorType*可讀寫Long類型，指定 Recordset游標的類型，見 CursorType用到的常數(shù)， 默認值是forward-only游標個人收集整理勿做商業(yè)用途DataMember 指針類型，指向關聯(lián)的DataEnvironment.Command 對象DataSource 指針類型，指向關聯(lián)的DataEnvironment.Connection 對象EditMode* 只讀Long類型，返回 Recordset的編輯狀態(tài)，見 EditMode用到的常數(shù)EOF*只讀Boolean類型，假設為True，說明記錄指針已超出Recordse

5、t的最后一條記錄，并且沒有了當前記錄。個人收集整理 勿做商業(yè)用途Filter*可讀寫Variant類型，要么是一條件表達式一條有效的 SQL WHERE子句但又不出 現(xiàn)保存字 WHERE，要么是指向特定記錄的 Bookmark數(shù)組，要么是一個 Filter常數(shù)，詳見 Filter用至U的常數(shù)。個人收集整理勿做商業(yè)用途LockType*可讀寫Long類型，指定翻開 Recordset所使用的記錄鎖定方法。默認值是只讀， 對應于forward-only游標的只讀特性。見 LockType屬性用到的常數(shù)。個人收集整理勿做商業(yè)用途MarshalOptions可讀寫Long類型，指定客戶端改動后，應返回

6、哪個記錄集合，此屬性僅適 合于不常見的 ADOR.Recordset對象，此對象是 對象成員之一。 個人 收集整理勿做商業(yè)用途MaxRecords*可讀寫Long類型，指定SELECT查詢或存儲過程返回的最大記錄條數(shù)，默認值為0,即全部返回個人收集整理勿做商業(yè)用途PageCount只讀Long類型，返回Recordset所有的頁數(shù)，必須設定了 PageSize的值，PageCount的返回值才是真正有意義的。如果Recordset不支持PageCount屬性，那么返回值為-1個人收集整理勿做商業(yè)用途PageSize可讀寫Long類型，設置或返回一個邏輯頁所包含的記錄條數(shù)。使用邏輯頁可把大的Re

7、cordset分解為多個易處理的小局部。通常的做法是把PageSize設為 DataGrid、MsFlexGrid或層次型的FlexGrid控件所能顯示的記錄條數(shù)。 PageSize和鎖定Jet(2k)或鎖定SQL Server(6.5版及更早版本，2k;7.0版，8k)數(shù)據(jù)庫時用到的表頁面大小無關個人收集整理勿做商業(yè)用途PersistFormat可讀寫Long類型，設置或返回由調用 Save方法所創(chuàng)立的 Recordset文件的格 式。當前僅有一個值 adPersistADTG(默認格式：Advaneed Data TableGram)個人收集整理勿做 商業(yè)用途RecordCount*只讀L

8、ong類型，如果 Recordset支持近似定位或支持書簽，那么返回帶可流動 游標的Recordset所含有的記錄數(shù)；如果不支持，必須使用MoveLast方法以取得確實覆蓋了所有記錄的準確的RecordCount數(shù)值。如果 forward-only類型 Recordset有一條或多條記錄，Recordset返回-1(True),任何類型的空的 Recordset都將返回O(False)個人收集整理 勿做商業(yè) 用途Sort*可讀寫String類型，包含一條不含保存字ORDER BY的SQL ORDERY BY 子句，用以指定Recordset的排序方式個人收集整理勿做商業(yè)用途Source*可讀寫

9、Stri ng類型，可以是SQL語句、表名、存儲過程名或相關 Comma nd對象名。 如果提供了 Comma nd對象名，那么 Source將返回 Comma nd.Comma ndText的值。利用 Ope n 方法的參數(shù)IngOptions可以指定提供應 Source值的類型 個人收集整理勿做商業(yè)用途State可讀寫Long類型，為對象狀態(tài)常數(shù)之一。見State常數(shù)Status只讀Long類型，說明對 Recordset進行批處理或其他多記錄 (bulk)操作后的狀態(tài)。見Status屬性用到的常數(shù)個人收集整理 勿做商業(yè)用途注意：上表所列屬性是ADODB.Recordset對象的標準屬性，

10、即那些被關系數(shù)據(jù)庫的大多數(shù)通用 OLE DB數(shù)據(jù)提供者所支持的屬性。帶星號的屬性表示它與DAO.Recordset或rdoResultset對象的相應屬性完全一樣或很接近。個人收集整理勿做商業(yè)用途方法 方法用途AddNew* 向可更新的 Recordset添加一條新記錄。調用語法為 rstName.AddNewvarField|avarFields,varValue|avarValuese, 其中 varField 是單個字段名， avarFields是字段名數(shù)組。varValue是單個字段值，avarValue是由avarFields指定字段的值所組成的數(shù)組。調用 Update方法那么把新記

11、錄加到數(shù)據(jù)庫的表中。如果向主關鍵字不是第一 個字段的Recordset中添加記錄，那么必須在AddNew方法中指定主關鍵字的名稱和值個人收集整理勿做商業(yè)用途Cancel取消異步查詢的執(zhí)行，中止存儲過程或復合SQL語句創(chuàng)立多個 Recordset，調用語法為rstName.Cancel個人收集整理 勿做商業(yè)用途CancelBatch*取消LockEdit值為BatchOptimistic的Recordset的即將生效的批量更新操作， 調用語法為：rstName.CancelBatch IngAffectRecords,可選參數(shù) IngAffectRecords 的取值見 lngAffectRec

12、ords用到的常數(shù)個人收集整理勿做商業(yè)用途Clone復制一個帶有獨立記錄指針 的 Recordset對象，調用語法為：Set rstDupe=rstName.Clone()個人收集整理勿做商業(yè)用途Close關閉Recordset對象，以后可以重新設Recordset的屬性并使用 Open方法來再度訪問Recordset。調用語法為：rstName.Close個人收集整理勿做商業(yè)用途Delete* 如果 Recordset 的 LockEdit 屬性值未設為 adLockBatchOptimistic，立刻從 Recordset 和相應表中刪除當前記錄 個人收集整理勿做商業(yè)用途Find尋找滿足指

13、定條件的記錄。調用語法為：rstName.Find strCriteria ,lngSkipRecords,IngSearchDirection ,lngStart,其中 strCriteria 是不含 WHERE 關鍵字的 SQL WHERE 子句， 可選參數(shù)lngSkipRecords是應用 Find前所跳過的記錄數(shù)目，lngDirection 指定查找方向adSearchForward,和 adSearchBackward,其中 adSearchForward 是默認值,可選參數(shù) IngStart 指 定了從哪兒開始查找，其值要么是一個Bookmark值，要么是 Bookmark常數(shù)，見

14、varStart參數(shù)用到的Bookmark常數(shù)。個人收集整理勿做商業(yè)用途GetRows 返回一個二維 Varia nt數(shù)組行、列，調用語法為 avar name=rstName.GetRowsl ngRows,varStart,strFieldName|lngFieldIndex|avarFieldNames|avarFieldlndexes,其中 lngRows 是返 回記錄行數(shù)，varStart指定從哪兒開始查找，其值要么是一個 Bookmark值，要么是Bookmark常數(shù)，見varStart參數(shù)用到的Bookmark常數(shù)。第三個參數(shù)可以是單個列字段的名稱或 索引，也可以是多個列名稱或索

15、引組成的Variant數(shù)組。如果不指定第三個參數(shù)，GetRows返回Recordset中所有列。個人收集整理勿做商業(yè)用途GetString默認情況下，返回指定數(shù)目記錄的String串值，記錄間由返回代碼分隔。記錄內由 tab 分隔。 調用語法為：strClip=rst name.GetStri ngln gRows,strCloumnDelimiter,strRowDelimiter,strNullExpr。其中 IngRows 為返回記錄行數(shù)，strColumnDelimiter為可選的列分隔符vbTab是默認值,strRowDelimiter是可選的行分隔符 vbCr是默認值，strNul

16、lExpr是可選參數(shù)，用于碰到Null值時的替代值默認值是空字符串。GetString的主要用途是通過把控件的Clip屬性設為strClip來處理 MSFIexGrid 或MSHFlexGrid 控件個人收集整理勿做商業(yè)用途Move*從當前記錄移動記錄指針。調用語法為：rstName.Move IngNumRecords , varStart,其中IngNumRecords是要跳過的記錄數(shù)，可選選參數(shù)varStart指定從哪開始移動。其值要么是一個 Bookmark值，要么是 Bookmark常數(shù)，見varStart參數(shù)用到的 Bookmark常數(shù)。 個人 收集整理勿做商業(yè)用途MoveFirs

17、t*移動記錄指針到第一條記錄，調用語法為：rstName.MoveFirstMoveLast*移動記錄指針到最后一條記錄，調用語法為：rstName.MoveLastMoveNext移動記錄指針到下一條記錄，調用語法為：rstName.MoveNext。它是能用于forward-only Recordset的唯一 Move方法個人收集整理勿做商業(yè)用途MovePrevious*移動記錄指針到前一條記錄，調用語法為：rstName.MovePrevious個人收集整理勿做商業(yè)用途NextRecordset返回另外的 Recordset,它通常由能產生多個Recordset的復合 SQL語句如SEL

18、ECT * FROM orders;SELECT * FROM customers或存儲過程來創(chuàng)立。調用語法為 Next=rstName.NextRecordset IngRecordsAffected,其中可選參數(shù) IngRecordsAffected 指定返 回到rstNext中去的記錄數(shù)目。如果已不存在Recordset， rstNext被設為Nothing個人收集整理勿做商業(yè)用途Ope n在一個活動Comma nd 或 Conn ection 對象上翻開一個Recordset，調用語法為：rstName.Ope n varSource , varActiveC onnection, I

19、n gCursorType , In gLockType ,IngOptions。這些參數(shù)都是可選的，個人收集整理勿做商業(yè)用途Requery重新從表中獲取 Recordset的內容，等效于 Close后再Open。它是一個資源集中型 操作。語法為：rstName.Requery個人收集整理勿做商業(yè)用途Resync* 重新從表中獲取局部 Recordset 內容。調用語法為 rstName.Resync IngAffectRecords, 其中IngAffectRecords的取值見IngAffectRecords 用到的常數(shù)。如果把該參數(shù)設為 adAffectCurrent或adAffectG

20、roup，那么比adAffectAII默認值所耗的資源要少。個人收集整理 勿做商業(yè)用途Save創(chuàng)立包含 Recordset永久性拷貝的文件。調用語法為rstName.Save strFileName。其中strFileName為路徑和文件名。通常用.rst作為文件的擴展名。個人收集整理 勿做商業(yè)用途Supports如果數(shù)據(jù)提供者支持指定的游標相關的方法，那么返回True，否那么返回為False。調用語法為 Supported=rstname.Supports IngCursorOptions.關于 IngCursorOptions,見 Supports 方法用至曲勺常數(shù)。 個人收集整理勿做商業(yè)

21、用途Update*使對Recordset的修改對底層數(shù)據(jù)源中的表生效。對于批量操作，Update方法只使修改對本地CachedRecordset生效。調用語法為 rstName.Update個人收集整理勿做商業(yè)用途UpdateBatch* 合對指量類型的RecordsetLockType 屬性值為 adBatchOptimistic,CursorType屬性值為adOpenKeyset或adOpenStatic所做的修改對底層數(shù)據(jù)源中的表生效。調用語法為 rstName.UpdateBatch lngAfectRecords,其中 lngAffectRecords 的取值見 IngAffect

22、records 用到 的常數(shù)。個人收集整理勿做商業(yè)用途注：ADODB.Recordset對象不支持 Edit方法。為了改變 ADODB.Recordset對象當前記錄的 一個或多個字段的值，可以先使用rstName.Fieldsn.Value=varValue把相應字段的值改為所需要的值，而后執(zhí)行 rstName.Update即可。個人收集整理勿做商業(yè)用途事件事件名稱觸發(fā)時機EndOfRecordset記錄指針試圖移到最后一條記錄之外時FieldchangeComplete字段值的改變完成之后 MoveComplete Move 或 Move.方法執(zhí)行之后 RecordsCha ngeComp

23、lete對單個記錄編輯完成以后 RecordsetCha ngeComplete緩存中的改變對底層表生效之后 WillCha ngField對字段值改變之前WillChangeRecord對單個記錄改變之前WillChangeRecordset緩存中的改變對底層表生效之前WillMove Move或Move.方法執(zhí)行之前adReason參數(shù)。該參數(shù)的取值見 adReason參數(shù)用Recordset為空，或數(shù)據(jù)提供者不能確定頁碼。BOF屬性值為TrueEOF屬性值為True注：事件處理模塊的函數(shù)頭幾乎都用到了至曲勺常數(shù)。 個人收集整理 勿做商業(yè)用途 常數(shù)AbsolutePage屬性用到的常數(shù)常數(shù)

24、含義adPosUnknown數(shù)據(jù)提供者不支持頁面, adPosBOF記錄指針定位于文件開頭 adPosEOF記錄指針定位于文件結尾CursorLocation屬性用到的常數(shù)常數(shù)含義adUseClient使用客戶端游標庫提供的游標。ADODB.Recordset要求客戶端游標adUseServer使用數(shù)據(jù)源提供的游標，通常但非絕對位于效勞器上默認值 CursorType屬性用到的常數(shù)常數(shù)含義adOpenForwardonly提供單向移動游標和只讀Recordset 默認值adOpenDynamic提供可滾動游標，可顯示其他用戶對Recordset所做的改動包括添加新記錄個人收集整理勿做商業(yè)用途d

25、ynaset類型的adOpenKeyset提供可滾動游標，只隱藏其他用戶所做的改動，類似于DAO.Recordset個人收集整理勿做商業(yè)用途adOpe nStatic提供一個位于Recordset靜態(tài)拷貝上的可滾動游標，類似于snap shot類型的DAO.Recordset，但多了可更新特性個人收集整理勿做商業(yè)用途EditMode屬性用到的常數(shù)常數(shù)含義adEditNone無正在進行的編輯操作默認值 adEditAdd臨時添加一條記錄，但尚未存入數(shù)據(jù)庫的表中 adEditlnProgress當前記錄中的數(shù)據(jù)已經改動，但尚未存入數(shù)據(jù)庫的表中 Filter屬性用到的常數(shù) 常數(shù)含義adFilterN

26、one除去已有的過濾器，顯示Recordset中的所有記錄等效于把Filter屬性置為空串，默認值個人收集整理勿做商業(yè)用途adfilterAffectedRecords 只顯示上次 CancelBatch、Delete> Resync或 UpdateBatch 方法執(zhí)行后 所影響的記錄 個人收集整理 勿做商業(yè)用途adFilterFetchedRecords只當前 Cache中的記錄，記錄條數(shù)由 CacheSize來確定 個人收集整理 勿 做商業(yè)用途adFilterPendingRecords只顯示已改動但尚未被數(shù)據(jù)源處理的記錄僅適用于批量更新模式個人收集整理勿做商業(yè)用途LockType屬

27、性用到的常數(shù)常數(shù)含義adLockRecordOnly指定只讀訪問默認值 adLockBatchOptimistic使用批量更新模式而不是默認的立即更新模式adLockOptimistic使用樂觀鎖僅在更新過程中才鎖定記錄或頁面adLockPessimistic使用悲觀鎖編輯或更新整個過程中均鎖定記錄或頁面State常數(shù)常數(shù)含義adStateClosed Connection或其他對象是關閉的默認值adStateCo nn ecti ng正在連接數(shù)據(jù)源的狀態(tài)adStateExecuti ng Co nn ection或Comma nd對象的Execute方法已被調用個人收集整理勿做商業(yè)用途adS

28、tateFetching 返回行row到 Recordset 對象adStateOpen Connection或其他對象是翻開的活動的Status屬性用到的常數(shù)僅適用于Batch或Bulk Recordset操作 常數(shù)含義adRecOK成功更新adRecNew成功添加adRecModified 成功修改adRecDeleted成功刪除adRecUnmodified 無改動adRec In valid未保存：Bookmark屬性無效 adRecMultipleChanges未保存：保存會影響其他記錄 adRecPe ndi ngCha nges未保存：記錄引用了一個等待插入操作 adRecCa

29、nceled未保存：操作被取消 adRecCa ntRelease未保存：現(xiàn)有記錄值阻止了保存adRecCo ncurre ncyViolation 未保存：樂觀并發(fā)鎖發(fā)生了問題adRec In tegrityViolation 未保存：操作會影響一致性 adRecMaxCha ngesExceeded未保存：存在太多的等待改動 adRecObjectOpe n未保存：翻開存貯對象發(fā)生沖突 adRecOutofMemory未保存：內存缺乏 adRecPermissio nDe nied未保存：用戶權限不夠 adRecSchemaViolation未保存：記錄的結構不符合數(shù)據(jù)庫中的定義 adRecDBDeleted未保存或刪除：記錄已被刪除 lngAffectRecords參數(shù)用到的常數(shù) Comma nd類型常數(shù)含義adAffectAll包括Recordset對象的所有記錄