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)