レコードセット : スクロール (ODBC)

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

このトピックの内容は、MFC ODBC クラスに該当します。

レコードセットを開いたら、各レコードにアクセスして値の表示、計算、レポート生成などを行います。レコードにアクセスするには、スクロールによってレコードセット内のレコード間を移動します。

このトピックでは、次の内容について説明します。

レコードセット内のレコード間を移動 (スクロール) する方法
スクロールが利用できる条件

レコードセット内のレコード間を移動 (スクロール) する方法

CRecordset クラスには、レコードセット内をスクロールするための Move メンバ関数が用意されています。各メンバ関数は、データを現在のレコードから行セット単位でスクロールします。バルク行フェッチを実装している場合、レコードセットのレコードは、Move を呼び出すごとに行セット単位でスクロールされます。バルク行フェッチを実装していない場合、Move を呼び出すごとに、レコードセットのレコードは 1 つだけスクロールされます。バルク行フェッチの詳細については、「レコードセット : バルク行フェッチ (ODBC)」を参照してください。

メモ :
レコードセット内を移動するときに、削除したレコードがスキップされないことがあります。詳細については、IsDeleted メンバ関数に関するトピックを参照してください。

CRecordset には、Move 関数のほかに、レコードセットの先頭または末尾を越えてスクロールしたかどうかを調べるためのメンバ関数も用意されています。

レコードセット内でスクロールできるかどうかを調べるには、メンバ関数 CanScroll を呼び出します。

スクロールを行うには

次のレコードまたは行セットに進むには、メンバ関数 MoveNext を呼び出します。
1 つ前のレコードまたは行セットに戻るには、メンバ関数 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 が 0 以外の値を返します。レコードセットが最初のレコードより前 (すべてのレコードの前) に配置されている場合は、IsBOF が 0 以外の値を返します。いずれの場合も、操作対象となる現在のレコードがありません。IsBOF が TRUE の場合に MovePrev を呼び出すか、IsEOF が TRUE の場合に MoveNext を呼び出すと、フレームワークによって CDBException がスローされます。IsBOF と IsEOF の両方を使用すると、レコードセットが空かどうかを調べることもできます。

レコードセットの移動の詳細については、「レコードセット : ブックマークと絶対位置 (ODBC)」を参照してください。

スクロールが利用できる条件

SQL は、本来前方向へのスクロールだけを行うようにデザインされていますが、ODBC によって両方向にスクロールできるように拡張されています。スクロールのサポートレベルは、アプリケーションで使用する ODBC ドライバの種類、ドライバの ODBC API 準拠レベル、および ODBC カーソルライブラリがメモリに読み込まれているかどうかによって異なります。詳細については、「ODBC の基礎」と「ODBC : ODBC カーソルライブラリ」を参照してください。

ヒント :
プログラマは、カーソルライブラリを使用するかどうかを選択できます。「CDatabase::Open」の bUseCursorLib パラメータおよび dwOptions パラメータを参照してください。

メモ :
MFC DAO クラスとは異なり、MFC ODBC クラスには、指定した条件に合致するレコードに移動するための一連の Find 関数がありません。