EndOfRecordset イベント (ADO)
適用先: Access 2013、Office 2013
EndOfRecordset イベントは、Recordset の末尾を越える行に移動しようとすると呼び出されます。
構文
EndOfRecordsetfMoreData、 adStatus、 pRecordset
パラメーター
パラメーター | 説明 |
---|---|
fMoreData | VARIANT_BOOL の値です。VARIANT_TRUE に設定されている場合は、 Recordset に行が追加されていることを示します。 |
adStatus | EventStatusEnum。 EndOfRecordset が呼び出されたとき、イベントを発生させた操作が成功した場合、このパラメーターは adStatusOK に設定されます。 イベントを発生させた操作の取り消しをこのイベントが要求できない場合、このパラメーターは adStatusCantDeny に設定されます。 EndOfRecordset から制御が戻る前に後続の通知が行われるのを防ぐには、このパラメーターを adStatusUnwantedEvent に設定します。 |
pRecordset | Recordset オブジェクト。 このイベントが発生した Recordset オブジェクトです。 |
注釈
EndOfRecordset イベントは、 MoveNext 操作が失敗した場合に発生することがあります。
このイベント ハンドラーは、たとえば MoveNext を呼び出して、 Recordset オブジェクトの末尾を越えて移動しようとすると呼び出されます。 ただし、このイベントの中で、データベースからさらにレコードを取得し、それらを Recordset の末尾に追加することもできます。 そのためには、fMoreData を VARIANT_TRUE に設定し、EndOfRecordset から制御を戻す必要があります。 その後で MoveNext を再度呼び出して、新たに取得したレコードにアクセスします。