ADO Recordset 对象

男娘i 2024-03-27 19:18 12阅读 0赞

### 实例 ###

[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 对象的所有方法和属性。

--------------------

### 属性 ###

<table> 
 <tbody> 
  <tr> 
   <th>属性</th> 
   <th>描述</th> 
  </tr> 
  <tr> 
   <td>AbsolutePage</td> 
   <td>设置或返回一个可指定 Recordset 对象中页码的值。</td> 
  </tr> 
  <tr> 
   <td>AbsolutePosition</td> 
   <td>设置或返回一个值，此值可指定 Recordset 对象中当前记录的顺序位置（序号位置）。</td> 
  </tr> 
  <tr> 
   <td>ActiveCommand</td> 
   <td>返回与 Recordset 对象相关联的 Command 对象。</td> 
  </tr> 
  <tr> 
   <td>ActiveConnection</td> 
   <td>如果连接被关闭，设置或返回连接的定义，如果连接打开，设置或返回当前的 Connection 对象。</td> 
  </tr> 
  <tr> 
   <td>BOF</td> 
   <td>如果当前的记录位置在第一条记录之前，则返回 true，否则返回 fasle。</td> 
  </tr> 
  <tr> 
   <td>Bookmark</td> 
   <td>设置或返回一个书签。此书签保存当前记录的位置。</td> 
  </tr> 
  <tr> 
   <td>CacheSize</td> 
   <td>设置或返回能够被缓存的记录的数目。</td> 
  </tr> 
  <tr> 
   <td>CursorLocation</td> 
   <td>设置或返回游标服务的位置。</td> 
  </tr> 
  <tr> 
   <td>CursorType</td> 
   <td>设置或返回一个 Recordset 对象的游标类型。</td> 
  </tr> 
  <tr> 
   <td>DataMember</td> 
   <td>设置或返回要从 DataSource 属性所引用的对象中检索的数据成员的名称。</td> 
  </tr> 
  <tr> 
   <td>DataSource</td> 
   <td>指定一个包含要被表示为 Recordset 对象的数据的对象。</td> 
  </tr> 
  <tr> 
   <td>EditMode</td> 
   <td>返回当前记录的编辑状态。</td> 
  </tr> 
  <tr> 
   <td>EOF</td> 
   <td>如果当前记录的位置在最后的记录之后，则返回 true，否则返回 fasle。</td> 
  </tr> 
  <tr> 
   <td>Filter</td> 
   <td>返回一个针对 Recordset 对象中数据的过滤器。</td> 
  </tr> 
  <tr> 
   <td>Index</td> 
   <td>设置或返回 Recordset 对象的当前索引的名称。</td> 
  </tr> 
  <tr> 
   <td>LockType</td> 
   <td>设置或返回当编辑 Recordset 中的一条记录时，可指定锁定类型的值。</td> 
  </tr> 
  <tr> 
   <td>MarshalOptions</td> 
   <td>设置或返回一个值，此值指定哪些记录被返回服务器。</td> 
  </tr> 
  <tr> 
   <td>MaxRecords</td> 
   <td>设置或返回从一个查询返回 Recordset 对象的的最大记录数目。</td> 
  </tr> 
  <tr> 
   <td>PageCount</td> 
   <td>返回一个 Recordset 对象中的数据页数。</td> 
  </tr> 
  <tr> 
   <td>PageSize</td> 
   <td>设置或返回 Recordset 对象的一个单一页面上所允许的最大记录数。</td> 
  </tr> 
  <tr> 
   <td>RecordCount</td> 
   <td>返回一个 Recordset 对象中的记录数目。</td> 
  </tr> 
  <tr> 
   <td>Sort</td> 
   <td>设置或返回一个或多个作为 Recordset 排序基准的字段名。</td> 
  </tr> 
  <tr> 
   <td>Source</td> 
   <td>设置一个字符串值，或一个 Command 对象引用，或返回一个字符串值，此值可指示 Recordset 对象的数据源。</td> 
  </tr> 
  <tr> 
   <td>State</td> 
   <td>返回一个值，此值可描述是否 Recordset 对象是打开、关闭、正在连接、正在执行或正在取回数据。</td> 
  </tr> 
  <tr> 
   <td>Status</td> 
   <td>返回有关批更新或其他大量操作的当前记录的状态。</td> 
  </tr> 
  <tr> 
   <td>StayInSync</td> 
   <td>设置或返回当父记录位置改变时对子记录的引用是否改变。</td> 
  </tr> 
 </tbody> 
</table>

### 方法 ###

<table> 
 <tbody> 
  <tr> 
   <th>方法</th> 
   <th>描述</th> 
  </tr> 
  <tr> 
   <td>AddNew</td> 
   <td>创建一条新记录。</td> 
  </tr> 
  <tr> 
   <td>Cancel</td> 
   <td>撤销一次执行。</td> 
  </tr> 
  <tr> 
   <td>CancelBatch</td> 
   <td>撤销一次批更新。</td> 
  </tr> 
  <tr> 
   <td>CancelUpdate</td> 
   <td>撤销对 Recordset 对象的一条记录所做的更改。</td> 
  </tr> 
  <tr> 
   <td>Clone</td> 
   <td>创建一个已有 Recordset 的副本。</td> 
  </tr> 
  <tr> 
   <td>Close</td> 
   <td>关闭一个 Recordset。</td> 
  </tr> 
  <tr> 
   <td>CompareBookmarks</td> 
   <td>比较两个书签。</td> 
  </tr> 
  <tr> 
   <td>Delete</td> 
   <td>删除一条记录或一组记录。</td> 
  </tr> 
  <tr> 
   <td>Find</td> 
   <td>搜索一个 Recordset 中满足指定某个条件的一条记录。</td> 
  </tr> 
  <tr> 
   <td>GetRows</td> 
   <td>把多条记录从一个 Recordset 对象中拷贝到一个二维数组中。</td> 
  </tr> 
  <tr> 
   <td>GetString</td> 
   <td>将 Recordset 作为字符串返回。</td> 
  </tr> 
  <tr> 
   <td>Move</td> 
   <td>在 Recordset 对象中移动记录指针。</td> 
  </tr> 
  <tr> 
   <td>MoveFirst</td> 
   <td>把记录指针移动到第一条记录。</td> 
  </tr> 
  <tr> 
   <td>MoveLast</td> 
   <td>把记录指针移动到最后一条记录。</td> 
  </tr> 
  <tr> 
   <td>MoveNext</td> 
   <td>把记录指针移动到下一条记录。</td> 
  </tr> 
  <tr> 
   <td>MovePrevious</td> 
   <td>把记录指针移动到上一条记录。</td> 
  </tr> 
  <tr> 
   <td>NextRecordset</td> 
   <td>通过执行一系列命令清除当前 Recordset 对象并返回下一个 Recordset。</td> 
  </tr> 
  <tr> 
   <td>Open</td> 
   <td>打开一个数据库元素，此元素可提供对表的记录、查询的结果或保存的 Recordset 的访问。</td> 
  </tr> 
  <tr> 
   <td>Requery</td> 
   <td>通过重新执行对象所基于的查询来更新 Recordset 对象中的数据。</td> 
  </tr> 
  <tr> 
   <td>Resync</td> 
   <td>从原始数据库刷新当前 Recordset 中的数据。</td> 
  </tr> 
  <tr> 
   <td>Save</td> 
   <td>把 Recordset 对象保存到 file 或 Stream 对象中。</td> 
  </tr> 
  <tr> 
   <td>Seek</td> 
   <td>搜索 Recordset 的索引以快速定位与指定的值相匹配的行，并使其成为当前行。</td> 
  </tr> 
  <tr> 
   <td>Supports</td> 
   <td>返回一个布尔值，此值可定义 Recordset 对象是否支持特定类型的功能。</td> 
  </tr> 
  <tr> 
   <td>Update</td> 
   <td>保存所有对 Recordset 对象中的一条单一记录所做的更改。</td> 
  </tr> 
  <tr> 
   <td>UpdateBatch</td> 
   <td>把所有 Recordset 中的更改存入数据库。请在批更新模式中使用。</td> 
  </tr> 
 </tbody> 
</table>

### 事件 ###

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

<table> 
 <tbody> 
  <tr> 
   <th>事件</th> 
   <th>描述</th> 
  </tr> 
  <tr> 
   <td>EndOfRecordset</td> 
   <td>当试图移动到超过 Recordset 结尾的行时被触发。</td> 
  </tr> 
  <tr> 
   <td>FetchComplete</td> 
   <td>当异步操作中的所有记录均被读取后被触发。</td> 
  </tr> 
  <tr> 
   <td>FetchProgress</td> 
   <td>在异步操作期间被定期地触发，报告已读取多少记录。</td> 
  </tr> 
  <tr> 
   <td>FieldChangeComplete</td> 
   <td>Field 对象的值更改被触发。</td> 
  </tr> 
  <tr> 
   <td>MoveComplete</td> 
   <td>Recordset 中的当前位置更改后被触发。</td> 
  </tr> 
  <tr> 
   <td>RecordChangeComplete</td> 
   <td>一条记录更改之后被触发。</td> 
  </tr> 
  <tr> 
   <td>RecordsetChangeComplete</td> 
   <td>在 Recordset 更改之后被触发。</td> 
  </tr> 
  <tr> 
   <td>WillChangeField</td> 
   <td>在 Field 对象的值更改之前被触发</td> 
  </tr> 
  <tr> 
   <td>WillChangeRecord</td> 
   <td>在一条记录更改之前被触发。</td> 
  </tr> 
  <tr> 
   <td>WillChangeRecordset</td> 
   <td>在 Recordset 更改之前被触发。</td> 
  </tr> 
  <tr> 
   <td>WillMove</td> 
   <td>在 Recordset 中的当前位置更改之前被触发。</td> 
  </tr> 
 </tbody> 
</table>

### 集合 ###

<table> 
 <tbody> 
  <tr> 
   <th>集合</th> 
   <th>描述</th> 
  </tr> 
  <tr> 
   <td>Fields</td> 
   <td>指示在此 Recordset 对象中 Field 对象的数目。</td> 
  </tr> 
  <tr> 
   <td>Properties</td> 
   <td>包含所有 Recordset 对象中的 Property 对象。</td> 
  </tr> 
 </tbody> 
</table>

### Fields 集合的属性 ###

<table> 
 <tbody> 
  <tr> 
   <th>属性</th> 
   <th>描述</th> 
  </tr> 
  <tr> 
   <td>Count</td> 
   <td> <p>返回 fields 集合中项目的数目。以 0 起始。</p> <p>例子：</p> <pre>countfields = rs.Fields.Count</pre> </td> 
  </tr> 
  <tr> 
   <td>Item(named_item/number)</td> 
   <td> <p>返回 fields 集合中的某个指定的项目。</p> <p>例子：</p> <pre>itemfields = rs.Fields.Item(1)
或者&nbsp;&nbsp;&nbsp;&nbsp;
itemfields = rs.Fields.Item(&amp;quot;Name&amp;quot;)
</pre> </td> 
  </tr> 
 </tbody> 
</table>

### Properties 集合的属性 ###

<table> 
 <tbody> 
  <tr> 
   <th>属性</th> 
   <th>描述</th> 
  </tr> 
  <tr> 
   <td>Count</td> 
   <td> <p>返回 properties 集合中项目的数目。以 0 起始。</p> <p>例子：</p> <pre>countprop = rs.Properties.Count</pre> </td> 
  </tr> 
  <tr> 
   <td>Item(named_item/number)</td> 
   <td> <p>返回 properties 集合中某个指定的项目。</p> <p>例子：</p> <pre>itemprop = rs.Properties.Item(1)
或者
itemprop = rs.Properties.Item(&amp;quot;Name&amp;quot;)</pre> </td> 
  </tr> 
 </tbody> 
</table>

[GetRows]: http://www.voidme.com/link?url=https://www.voidme.com/try/showasp.php?filename=demo_ado_getrows