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)

DB_ERROR_IN_ASYNC_EXECUTE
ステートメントが非同期実行処理中です。
DB_ERROR_ARGUMENT_OUT_OF_RANGE
引数dwMaxSizeが1より小さい値です。