CRecordset::SetRowsetSize

更新 : 2007 年 11 月

フェッチで取得するレコードの数を指定します。

virtual void SetRowsetSize(
   DWORD dwNewRowsetSize 
);

パラメータ

  • dwNewRowsetSize
    1 回のフェッチで取得される行数。

解説

この仮想メンバ関数は、バルク行フェッチを使用した場合は、1 回のフェッチで取得する行数を指定します。バルク行フェッチを実装するには、Open メンバ関数で dwOptions パラメータに CRecordset::useMultiRowFetch オプションを指定します。

cwh5586c.alert_note(ja-jp,VS.90).gifメモ :

バルク行フェッチを実装しないで SetRowsetSize を呼び出すと、アサートします。

Open を呼び出す前に SetRowsetSize を呼び出して、レコードセットの行セットのサイズを設定します。バルク行フェッチを実装したときの既定の行セット サイズは 25 です。

cwh5586c.alert_note(ja-jp,VS.90).gifメモ :

SetRowsetSize は慎重に使用してください。Open の dwOptions パラメータに CRecordset::userAllocMultiRowBuffers オプションを指定したときのようにデータの記憶場所を手動で割り当てている場合は、SetRowsetSize を呼び出した後、カーソル移動操作を行う前に、これらの記憶バッファを再割り当てする必要があるかどうかをチェックする必要があります。

行セット サイズの現在の設定値を取得するには、GetRowsetSize を呼び出します。

バルク行フェッチの詳細については、「レコードセット : バルク行フェッチ (ODBC)」を参照してください。

必要条件

ヘッダー : afxdb.h

参照

参照

CRecordset クラス

階層図

CRecordset::Open

CRecordset::GetRowsetSize

CRecordset::CheckRowsetError

CRecordset::DoBulkFieldExchange

その他の技術情報

CRecordset のメンバ