记录集：滚动 (ODBC)

项目
08/18/2008

更新：2007 年 11 月

本主题适用于 MFC ODBC 类。

打开记录集后，需要访问记录以显示值、进行计算、生成报表等。滚动使您得以在记录集中的记录之间移动。

本主题说明：

从一个记录滚动到记录集中另一个记录的方式。
支持滚动和不支持滚动的情形。

从一个记录滚动到另一个记录

CRecordset 类提供 Move 成员函数用来在记录集中滚动。这些函数按行集合移动当前记录。如果已实现批量取行，则 Move 操作按行集合的大小重新定位记录集。如果尚未实现批量取行，则对 Move 函数的调用按逐个记录重新定位记录集。有关批量取行的更多信息，请参见记录集：批量获取记录 (ODBC)。

说明：
通过记录集移动时，不能跳过已删除的记录。有关更多信息，请参见 IsDeleted 成员函数。

除了 Move 函数外，CRecordset 还提供用来检查是否已滚动过记录集的结尾或开头的成员函数。

若要确定在记录集中是否可以滚动，请调用 CanScroll 成员函数。

滚动

向前滚动一条记录或一个行集合：调用 MoveNext 成员函数。
向后滚动一条记录或一个行集合：调用 MovePrev 成员函数。
移动到记录集中的第一条记录：调用 moveFirst 成员函数。
滚动到记录集中的最后一条记录或最后一个行集合：调用 MoveLast 成员函数。
相对于当前位置的 N 条记录：调用 Move 成员函数。

测试是否已到记录集的结尾或开头

是否已滚过最后一条记录？调用 IsEOF 成员函数。
是否已滚出第一条记录（向后移动）？调用 IsBOF 成员函数。

下面的代码示例使用 IsBOF 和 IsEOF 检测在任一方向滚动时记录集的限制。

// Open a recordset; first record is current
CCustSet rsCustSet( NULL );
rsCustSet.Open( );

if( rsCustSet.IsBOF( ) )
    return;
    // The recordset is empty

// Scroll to the end of the recordset, past
// the last record, so no record is current
while ( !rsCustSet.IsEOF( ) )
    rsCustSet.MoveNext( );

// Move to the last record
rsCustSet.MoveLast( );

// Scroll to beginning of the recordset, before
// the first record, so no record is current
while( !rsCustSet.IsBOF( ) )
    rsCustSet.MovePrev( );

// First record is current again
rsCustSet.MoveFirst( );

如果将记录集定位在最后一条记录之后，则 IsEOF 返回一个非零值；如果将记录集定位在第一条记录之前（所有记录之前），则 IsBOF 返回一个非零值。两种情况下都没有要操作的当前记录。如果在 IsBOF 已为 TRUE 时调用 MovePrev，或在 IsEOF 已为 TRUE 时调用 MoveNext，则框架引发 CDBException。也可以使用 IsBOF 和 IsEOF 检查空记录集。