構文とオプションのパラメーター配列を指定して、準備済みの SQL 照会を実行します。
構文
void executePreparedSQL(String query) void executePreparedSQL(String query, Vector queryParameters)
パラメーター
戻り値
なし。
例外
CwDBSQLException - データベース・エラーが発生した場合です。
注記
executePreparedSQL() メソッドは、指定した query ストリングを準備済み SQL ステートメントとして、現行接続に関連付けられたデータベースに送信します。
この照会は、最初に実行されるときにストリングとしてデータベースに送信されます。データベースは、このストリングを実行可能形式 (準備済みステートメントと呼ばれる) にコンパイルし、SQL ステートメントを実行し、この準備済みステートメントを executePreparedSQL() に戻します。executePreparedSQL() メソッドは、この準備済みステートメントをメモリーに保管します。executePreparedSQL() は、何度も実行する必要がある SQL ステートメントに使用します。これに対して executeSQL() メソッドは、準備済みステートメントを保管しない ため、一度のみ実行すればよい照会の場合に有効です。
実行できる SQL ステートメントを以下に示します (必要なデータベース許可がある場合)。
検索されたデータにアクセスするには、hasMoreRows() メソッドと nextRow() メソッドを使用します。
接続が明示的なトランザクション・ブラケットを使用する場合は、beginTransaction() を使用して各トランザクションを明示的に開始し、commit() または rollback() を使用してトランザクションを終了する必要があります。
OUT パラメーターを使用してストアード・プロシージャーを実行するには、executeStoredProcedure() メソッドを使用してください。
参照項目
beginTransaction(), commit(), executeSQL(), executeStoredProcedure(), getDBConnection(), hasMoreRows(), nextRow(), rollBack()