ステートメント実行から結果データがすべて返されているかどうかを示します。

ステートメントが 1 つまたは複数の行を返す場合、このプロパティはすべての行が返されているかどうかを示します。SQLStatement オブジェクトの execute() メソッドが、prefetch 引数値を指定して呼び出されている場合、指定された行数の結果データだけが SQLResult オブジェクトの data プロパティに返されます。その後 SQLStatement.next() を呼び出すと、さらに別のデータを使用できるようになります。このプロパティは、最終的な結果が返された時期を特定するために使用します。

実行時は行数が不明なので、ステートメントが完了したと見なされる前は、データベースカーソルが最終行を越えて移動することに注意してください。SQLStatement.execute() メソッドが、prefetch 引数を指定して呼び出されている場合、結果セットの合計行数よりも 1 行以上多く要求しないと、結果として得られる SQLResult インスタンスの complete プロパティは true になりません。

関連項目

ステートメント実行、具体的には SQL SELECT ステートメントが実行された場合に、結果として返されるデータです。

ステートメントが 1 つまたは複数の行を返す場合、このプロパティは、プロパティ名が結果データセットの列名に対応しているオブジェクトを含む配列になります。ステートメントがデータを返さない場合、このプロパティは null になります。

SQL INSERT ステートメントによって最後に生成された行識別子です。

実行されたステートメントが INSERT ステートメントでない場合、この値は 0 になります。

行識別子は、データベース内のテーブルの行を一意に識別するために使用されます。この値は、データベースによって頻繁に生成されます。

主キーと生成される行識別子の詳細については、「CREATE TABLE」および「式」のセクション (どちらも付録「ローカルデータベースでの SQL サポート」にあります) を参照してください。

関連項目

操作によって影響を受ける行数を示します。INSERT、UPDATE または DELETE ステートメントによって直接指定されている変更だけがカウントされます。

トリガによる間接的な変更はカウントされません。トリガによる変更も含め、変更の合計数を特定するには、SQLConnection.totalChanges プロパティを使用します。

関連する SQL 操作が DELETE ステートメントで、WHERE 句が記述されていない (ステートメントによってテーブルの全行を削除する) 場合、削除された行数にかかわらず、rowsAffected プロパティは常に 0 になります。削除された行数を知る必要がある場合は、WHERE 句として WHERE 1 = 1 を記述します。この場合、すべての行が削除され、削除された行数が正確に rowsAffected プロパティに反映されます。ただし、削除される行数によっては、この方法によってステートメントのパフォーマンスに悪影響を与える場合があります。

関連項目

SQLResult インスタンスを作成します。一般に、SQLResult コンストラクタは開発者のコードでは直接呼び出されません。特定の SQLStatement インスタンスに関連付けられている SQLResult を取得するには、そのインスタンスの getResult() メソッドを呼び出します。execute() メソッドまたは next() メソッドの呼び出しで Responder インスタンスが指定されている場合、SQLResult インスタンスは、引数として結果ハンドラ関数にも渡されます。