5.7 DBResultSetクラスの詳細

検索結果を管理するには,DBResultSetクラスを利用します。このクラスは,検索結果の取得,そのためのカーソルの移動,更新などのメソッドを提供するクラスです。

DBResultSetオブジェクトが生成されると,フィールド値を参照するためのGetFieldメソッドや,更新のためのSetFieldメソッドではレコード単位にデータを扱います。どのレコードを処理対象にするかはカーソルを使います。カーソルの位置付いたレコードをカレントレコードと呼び,複数のレコードを処理するためにはカーソルを順次移動して処理対象を変更していきます。

参照専用
DBStatementオブジェクト,DBPreparedStatementオブジェクト又はDBCallableStatementオブジェクトのSetResultSetTypeメソッドでTYPE_NONEなどを指定して生成します。
参照専用のDBResultSetオブジェクトは,一度に複数のレコードを読み込めます。1度に読み込める最大レコードの数は,SetMaxRowsメソッド(DBStatementオブジェクト,DBPreparedStatementオブジェクト,又はDBCallableStatementオブジェクト)で指定できます。また,読み込んだレコードは,GetFieldメソッドを呼び出して参照します。
更新可能
DBStatementオブジェクト,DBPreparedStatementオブジェクト,又はDBCallableStatementオブジェクトのSetResultSetTypeメソッドでTYPE_EXCLUSIVEを指定して生成します(検索するレコードに対してロックをかけます)。
更新可能なDBResultSetオブジェクトは,一度に一つのレコードしか読み込めませんが,読み込んだレコードに対して,EditメソッドやUpdateメソッドなどの更新用のメソッドを使って直接データを変更できます。このため,個別にUPDATE文などのSQL文を使わなくても,検索したレコードを直接更新するアプリケーションを作成できます。
機 能メソッド名
カーソルをResultSetの先頭からn番目のレコードに移動します。Absolute
カーソルをResultSetの最後のレコードへ移動します。Bottom
カレントレコードを削除します。Delete
カレントレコードを更新するための準備をします。Edit
フィールド名称に対応するフィールドのインデクスを取得します。FindColumn
検索したすべてのレコードの先頭から数えた,カレントレコードの位置を取得します。GetCurrent
ResultSetの先頭レコードから数えた,カレントレコードの位置を取得します。GetCurrentOfResultSet
SQL文の非同期実行時のエラー情報を得るために,DBSQLCAオブジェクトへのポインタを取得します。GetErrorStatus
カレントレコードのフィールドの値を取得します。GetField
DBResultSetMetaDataオブジェクトを生成します。GetMetaData
ResultSetのレコードの総数を取得します。GetRowCount
DBResultSetオブジェクトに非同期実行中(又は実行待ち)のステートメントがあるかどうかを確認します。InExecute
カーソルの位置が,ResultSetのレコードの最後を超えたかどうかを確認します。IsEOF
フィールドの値がNULLかどうかを確認します。IsNull
カーソルを次のレコードへ移動します。Next
カーソルを次のResultSetの先頭へ移動します。PageNext
対象となるオブジェクトを生成したDBStatementオブジェクト,DBPreparedStatementオブジェクト,又はDBCallableStatementオブジェクトのポインタを取得します。Parent
カーソルを前のレコードへ移動します。Previous
先頭のレコードから再読み込みをします。Refresh
カーソルを現在のレコードの位置からn個分移動します。Relative
DBResultSetオブジェクト(自分自身)を削除します。Remove
指定されたフィールドにデータを設定します。SetField
指定されたフィールドにNULLを設定します。SetNull
カーソルをResultSetの先頭のレコードへ移動します。Top
フィールドの更新結果をデータベースへ通知します。Update
DBResultSetオブジェクトで要求した実行待ち,及び実行中の非同期処理が終了するまで待ちます。WaitForDataSource
<この節の構成>
Absoluteメソッド
Bottomメソッド
Deleteメソッド
Editメソッド
FindColumnメソッド
GetCurrentメソッド
GetCurrentOfResultSetメソッド
GetErrorStatusメソッド
GetFieldメソッド
GetMetaDataメソッド
GetRowCountメソッド
InExecuteメソッド
IsEOFメソッド
IsNullメソッド
Nextメソッド
PageNextメソッド
Parentメソッド
Previousメソッド
Refreshメソッド
Relativeメソッド
Removeメソッド
SetFieldメソッド
SetNullメソッド
Topメソッド
Updateメソッド
WaitForDataSourceメソッド