SetMaxRowsメソッド
機能
ResultSetに検索するレコード数の最大値を指定します。
形式
void SetMaxRows(UINT32 dwMaxSize=MAX_ROWS_DEFAULT) throw DBSQLCA
引数
dwMaxSize
ResultSetに検索するレコード数の最大値を指定します。必ず1以上を指定してください。
システムデフォルト値は,MAX_ROWS_DEFAULTです(=100が仮定されます)。
SQL/Kの場合,指定できる範囲は4096レコード以下です。
戻り値
なし
機能詳細
DBResultSetオブジェクトで取得できるレコード数の最大値を指定します。
一度の読み込み(GetResultSetメソッド,又はPageNextメソッドの呼び出し)で,データベースから取得するレコード数の最大値を設定します。
指定できるレコード数の範囲
指定できるレコード数の最大値は使用しているDBMSによって異なります。各DBMSごとに,指定できるレコード数の最大値を次に示します。
1レコードのフィールド数は,DBResultSetMetaDataオブジェクトのGetColumnCountメソッドを呼び出して取得できます。
更新可能なDBResultSetオブジェクトでの扱い
DBResultSetオブジェクトが更新可能なオブジェクトとして生成された場合(SetResultSetTypeメソッドの引数swTypeでTYPE_EXCLUSIVEを指定した場合),SetMaxRowsメソッドによる指定は無視され,常に1が仮定されます。更新可能なDBResultSetは常に1レコードだけを読み込みます。
発生する例外
DBSQLCA(RetCode)