反饋

Recordset對象

Recordset 對象。使用 ADO 時，通過 Recordset 對象可對幾乎所有數據進行操作。所有 Recordset （行）和字段（列）進行構造。由於提供者所支持的功能不同，某些 Recordset 方法或屬性有可能無效。

中文名: Recordset對象

作用: 創建 Recordset 對象
分類: 用來操作來自提供者的數據

Recordset對象説明

ADOR.Recordset 和 ADODB.Recordset 是用的 ProgID。由此產生的 Recordset 對象行為相同，與 ProgID 無關。ADOR.Recordset 隨 Microsoft Internet Explorer 安裝，而 ADODB.Recordset 則隨 ADO 安裝。Recordset 對象的行為受環境（即客户端、服務器、Internet Explorer 等）的影響。

Recordset對象ADO Recordset

ADO Recordset 對象用於容納一個來自數據庫表的記錄集。一個 Recordset 對象由記錄和列（字段）組成。

在 ADO 中，此對象是最重要且最常用於對數據庫的數據進行操作的對象。

Recordset對象ProgID

set objRecordset=Server.CreateObject("ADODB.recordset") 當您首次打開一個 Recordset 時，當前記錄指針將指向第一個記錄，同時 BOF 和 EOF 屬性為 False。如果沒有記錄，BOF 和 EOF 屬性為 True。

Recordset 對象能夠支持兩種更新類型：

立即更新 - 一旦調用 Update 方法，所有更改被立即寫入數據庫。批更新 - provider 將緩存多個更改，然後使用 UpdateBatch 方法把這些更改傳送到數據庫。在 ADO，定義了 4 種不同的遊標（指針）類型：

動態遊標 - 允許您查看其他用户所作的添加、更改和刪除鍵集遊標 - 類似動態遊標，不同的是您無法查看有其他用户所做的添加，並且它會防止您訪問其他用户已刪除的記錄。其他用户所做的數據更改仍然是可見的。

靜態遊標 - 提供記錄集的靜態副本，可用來查找數據或生成報告。此外，由其他用户所做的添加、更改和刪除將是不可見的。當您打開一個客户端 Recordset 對象時，這是被允許的遊標類型。僅向前遊標 - 只允許在 Recordset 中向前滾動。此外，由其他用户所做的添加、更改和刪除將是不可見的。可通過 CursorType 屬性或 Open 方法中的 CursorType 參數來設置遊標的類型。

註釋：並非所有的提供者（providers）支持 Recordset 對象的所有方法和屬性。

Recordset對象屬性

屬性	描述
AbsolutePage	設置或返回一個可指定 Recordset 對象中頁碼的值。
AbsolutePosition	設置或返回一個值，此值可指定 Recordset 對象中當前記錄的順序位置（序號位置）。
ActiveCommand	返回與 Recordset 對象相關聯的 Command 對象。
ActiveConnection	如果連接被關閉，設置或返回連接的定義，如果連接打開，設置或返回當前的 Connection 對象。
BOF	如果當前的記錄位置在第一條記錄之前，則返回 true，否則返回 false。
Bookmark	設置或返回一個書籤。此書籤保存當前記錄的位置。
CacheSize	設置或返回能夠被緩存的記錄的數目。
CursorLocation	設置或返回遊標服務的位置。
CursorType	設置或返回一個 Recordset 對象的遊標類型。
DataMember	設置或返回要從 DataSource 屬性所引用的對象中檢索的數據成員的名稱。
DataSource	指定一個包含要被表示為 Recordset 對象的數據的對象。
EditMode	返回當前記錄的編輯狀態。
EOF	如果當前記錄的位置在最後的記錄之後，則返回 true，否則返回 false。
Filter	返回一個針對 Recordset 對象中數據的過濾器。
Index	設置或返回 Recordset 對象的當前索引的名稱。
LockType	設置或返回當編輯 Recordset 中的一條記錄時，可指定鎖定類型的值。
MarshalOptions	設置或返回一個值，此值指定哪些記錄被返回服務器。
MaxRecords	設置或返回從一個查詢返回 Recordset 對象的的最大記錄數目。
PageCount	返回一個 Recordset 對象中的數據頁數。
PageSize	設置或返回 Recordset 對象的一個單一頁面上所允許的最大記錄數。
RecordCount	返回一個 Recordset 對象中的記錄數目。
Sort	設置或返回一個或多個作為 Recordset 排序基準的字段名。
Source	設置一個字符串值，或一個 Command 對象引用，或返回一個字符串值，此值可指示 Recordset 對象的數據源。
State	返回一個值，此值可描述是否 Recordset 對象是打開、關閉、正在連接、正在執行或正在取回數據。
Status	返回有關批更新或其他大量操作的當前記錄的狀態。
StayInSync	設置或返回當父記錄位置改變時對子記錄的引用是否改變。

Recordset對象方法

方法	描述
AddNew	創建一條新記錄。
Cancel	撤銷一次執行。
CancelBatch	撤銷一次批更新。
CancelUpdate	撤銷對 Recordset 對象的一條記錄所做的更改。
Clone	創建一個已有 Recordset 的副本。
Close	關閉一個 Recordset。
CompareBookmarks	比較兩個書籤。
Delete	刪除一條記錄或一組記錄。
Find	搜索一個 Recordset 中滿足指定某個條件的一條記錄。
GetRows	把多條記錄從一個 Recordset 對象中拷貝到一個二維數組中。
GetString	將 Recordset 作為字符串返回。
Move	在 Recordset 對象中移動記錄指針。
MoveFirst	把記錄指針移動到第一條記錄。
MoveLast	把記錄指針移動到最後一條記錄。
MoveNext	把記錄指針移動到下一條記錄。
NextRecordset	通過執行一系列命令清除當前 Recordset 對象並返回下一個 Recordset
MovePrevious	把記錄指針移動到上一條記錄。
Open	打開一個數據庫元素，此元素可提供對錶的記錄、查詢的結果或保存的 Recordset 的訪問。
Requery	通過重新執行對象所基於的查詢來更新 Recordset 對象中的數據。
Resync	從原始數據庫刷新當前 Recordset 中的數據。
Save	把 Recordset 對象保存到 file 或 Stream 對象中。
Seek	搜索 Recordset 的索引以快速定位與指定的值相匹配的行，並使其成為當前行。
Supports	返回一個布爾值，此值可定義 Recordset 對象是否支持特定類型的功能。
Update	保存所有對 Recordset 對象中的一條單一記錄所做的更改。
UpdateBatch	把所有 Recordset 中的更改存入數據庫。請在批更新模式中使用。

Recordset對象事件

Note: You cannot handle events using VBScript or JScript (only Visual Basic, Visual C++, and Visual J++ languages can handle events).

事件	描述
EndOfRecordset	當試圖移動到超過 Recordset 結尾的行時被觸發。
FetchComplete	當異步操作中的所有記錄均被讀取後被觸發。
FetchProgress	在異步操作期間被定期地觸發，報告已讀取多少記錄。
FieldChangeComplete	Field 對象的值更改被觸發。
MoveComplete	Recordset 中的當前位置更改後被觸發。
RecordChangeComplete	一條記錄更改之後被觸發。
WillChangeField	在 Field 對象的值更改之前被觸發
RecordsetChangeComplete	在 Recordset 更改之後被觸發。
WillChangeRecord	在一條記錄更改之前被觸發。
WillChangeRecordset	在 Recordset 更改之前被觸發。
WillMove	在 Recordset 中的當前位置更改之前被觸發。

Recordset對象集合

集合	描述
Fields	指示在此 Recordset 對象中 Field 對象的數目。
Properties	包含所有 Recordset 對象中的 Property 對象。

Recordset對象Fields 集合的屬性

屬性	描述
Count	返回 fields 集合中項目的數目。以 0 起始。例子： countfields = rs.Fields.Count
Item(named_item/number)	返回 fields 集合中的某個指定的項目。例子： itemfields = rs.Fields.Item(1)或者 itemfields = rs.Fields.Item("Name")

Recordset對象Properties 集合的屬性

屬性	描述
Count	返回 properties 集合中項目的數目。以 0 起始。例子： countprop = rs.Properties.Count
Item(named_item/number)	返回 properties 集合中某個指定的項目。例子： itemprop = rs.Properties.Item(1)或者 itemprop = rs.Properties.Item("Name")

Recordset對象遊標類型

?? 動態遊標 — 用於查看其他用户所作的添加、更改和刪除，並用於不依賴書籤的 Recordset 中各種類型的移動。如果提供者支持，可使用書籤。

?? 鍵集遊標 — 其行為類似動態遊標，不同的只是禁止查看其他用户添加的記錄，並禁止訪問其他用户刪除的記錄，其他用户所作的數據更改將依然可見。它始終支持書籤，因此允許 Recordset 中各種類型的移動。

?? 靜態遊標 — 提供記錄集合的靜態副本以查找數據或生成報告。它始終支持書籤，因此允許 Recordset 中各種類型的移動。其他用户所作的添加、更改或刪除將不可見。這是打開客户端 (ADOR) Recordset 對象時允許使用的遊標類型。

?? 僅向前遊標 — 除僅允許在記錄中向前滾動之外，其行為類似靜態遊標。這樣，當需要在 Recordset 中單程移動時就可提高性能。

在打開 Recordset 之前設置 CursorType 屬性來選擇遊標類型，或使用 Open 方法傳遞 CursorType 參數。部分提供者不支持所有遊標類型。請檢查提供者的文檔。如果沒有指定遊標類型，ADO 將默認打開僅向前遊標。

如果 CursorLocation 屬性被設置為 adUseClient 後打開 Recordset，則在返回的 Recordset 對象中，Field 對象的 UnderlyingValue 屬性不可用。對部分提供者（例如 Microsoft ODBC Provider for OLE DB 連同 Microsoft SQL Server），可以通過使用 Open 方法傳遞連接字符串，根據以前定義的 Connection 對象獨立地創建 Recordset 對象。ADO 仍然創建 Connection 對象，但它不將該對象賦給對象變量。不過，如果正在相同的連接上打開多個 Recordset 對象，就應該顯式創建和打開 Connection 對象，由此將 Connection 對象賦給對象變量。如果在打開 Recordset 對象時沒有使用該對象變量，即使在傳遞相同連接字符串的情況下，ADO 也將為每個新的 Recordset 創建新的 Connection 對象。

Recordset對象其它注意事項

打開 Recordset 時，當前記錄位於第一個記錄（如果有），並且 BOF 和 EOF 屬性被設置為 False。如果沒有記錄，BOF 和 EOF 屬性設置是 True。

假設提供者支持相關的功能，可以使用 MoveFirst、MoveLast、MoveNext 和 MovePrevious 方法以及 Move 方法，和 AbsolutePosition、AbsolutePage 和 Filter 屬性來重新確定當前記錄的位置。僅向前 Recordset 對象只支持 MoveNext 方法。當使用 Move 方法訪問每個記錄（或枚舉 Recordset）時，可使用 BOF 和 EOF 屬性查看是否移動已經超過了 Recordset 的開始或結尾。

Recordset 對象可支持兩類更新：立即更新和批更新。使用立即更新，一旦調用 Update 方法，對數據的所有更改將被立即寫入基本數據源。也可以使用 AddNew 和 Update 方法將值的數組作為參數傳遞，同時更新記錄的若干字段。

如果提供者支持批更新，可以使提供者將多個記錄的更改存入緩存，然後使用 UpdateBatch 方法在單個調用中將它們傳送給數據庫。這種情況應用於使用 AddNew、Update 和 Delete 方法所做的更改。調用 UpdateBatch 方法後，可以使用 Status 屬性檢查任何數據衝突並加以解決。

注意要執行不使用 Command 對象的查詢，應將查詢字符串傳遞給 Recordset 對象的 Open 方法。但是，在想要保持命令文本並重復執行或使用查詢參數時，仍然需要 Command 對象。