Latest web development tutorials

ADO Recordset 對象

實例

GetRows
本例演示如何使用GetRows 方法。

Recordset 對象

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

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

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對象的所有方法和屬性。

屬性

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

方法

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

事件

注意: 你不能使用VBScript 或者JScript 處理(只允許Visual Basic, Visual C++, 和Visual J++ 語言處理事件).

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

集合

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

Fields 集合的屬性

屬性 描述
Count

返回fields 集合中項目的數目。 以0 起始。

例子： 

countfields = rs.Fields.Count
Item(named_item/number)

返回fields 集合中的某個指定的項目。

例子： 

itemfields = rs.Fields.Item(1)
或者	
itemfields = rs.Fields.Item("Name")

Properties 集合的屬性

屬性 描述
Count

返回properties 集合中項目的數目。 以0 起始。

例子： 

countprop = rs.Properties.Count
Item(named_item/number)

返回properties 集合中某個指定的項目。

例子： 

itemprop = rs.Properties.Item(1)
或者
itemprop = rs.Properties.Item("Name")