WillChangeRecordset イベントは、保留中の操作で Recordset が変更される前に呼び出されます。RecordsetChangeComplete イベントは、Recordset が変更された後に呼び出されます。
構文
WillChangeRecordset adReason, adStatus, pRecordset
RecordsetChangeComplete adReason, pError, adStatus, pRecordset
パラメータ
adReason このイベントの原因を示す EventReasonEnum 値です。値は adRsnReQuery、adRsnReSynch、adRsnClose、adRsnOpen です。
adStatus EventStatusEnum ステータス値です。
WillChangeRecordset を呼び出したとき、イベントを発生する操作が成功した場合、このパラメータは adStatusOK に設定されます。保留中の操作の取り消しをこのイベントが要求できない場合、このパラメータは adStatusCantDeny に設定されます。
RecordsetChangeComplete が呼び出されたとき、イベントを発生する操作が成功した場合、このパラメータは adStatusOK に設定され、操作が失敗した場合 adStatusErrorsOccurred に、また、以前受け入れられた WillChangeRecordset イベントに関連付けられた操作が取り消された場合、adStatusCancel に設定されます。
WillChangeRecordset から返る前に、保留中の操作の取り消しを要求するには、このパラメータを adStatusCancel に設定します。
WillChangeRecordset または RecordsetChangeComplete から返る前に、後続の通知が実行されるのを防ぐには、このパラメータを adStatusUnwantedEvent に設定します。
pError Error オブジェクトです。adStatus の値が adStatusErrorsOccurred の場合に発生するエラーを示します。これ以外の場合は設定されません。
pRecordset Recordset オブジェクトです。このイベントによって発生した Recordset です。
解説
WillChangeRecordset イベントまたは RecordsetChangeComplete イベントは、Recordset Requery メソッドまたは Open メソッドにより発生します。
プロバイダがブックマークをサポートしていない場合、プロバイダから新しい行が取得されるたびに RecordsetChange イベントの通知が発生します。このイベントの発生頻度は、RecordsetCacheSize プロパティで決まります。