SetMaxRowsメソッド

機能

ResultSetに検索するレコード数の最大値を指定します。

形式

void SetMaxRows(UINT32 dwMaxSize=MAX_ROWS_DEFAULT) throw DBSQLCA

引数

dwMaxSize

ResultSetに検索するレコード数の最大値を,1以上4096以下の値で指定します。

システムデフォルト値は,MAX_ROWS_DEFAULTです(=100が仮定されます)。

戻り値

なし

機能詳細

DBResultSetオブジェクトで一度に取得できる最大レコード数を指定します。

一度の読み込み(GetResultSetメソッド,又はPageNextメソッドの呼び出し)で,データベースから取得するレコード数の最大値を設定します。

1レコードのフィールド数は,DBResultSetMetaDataオブジェクトのGetColumnCountメソッドを呼び出して取得できます。

このメソッドは,アクセスするDBMSがSQL Anywhere,Adaptive Server Anywhereの場合だけ利用できます。

更新可能な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より小さい)が指定されています。