WillChangeRecordset イベントと RecordsetChangeComplete イベント (ADO)

適用先: Access 2013、Office 2013

WillChangeRecordset イベントは、保留中の操作で Recordset が変更される前に呼び出されます。 RecordsetChangeComplete イベントは、Recordset が変更された後に呼び出されます。

構文

WillChangeRecordsetadReason、 adStatus、 pRecordset

RecordsetChangeCompleteadReason、 pError、 adStatus、 pRecordset

パラメーター

パラメーター	説明
adReason	このイベントの原因を示す EventReasonEnum 値です。 値は adRsnRequery 、 adRsnResynch 、 adRsnClose 、 adRsnOpen です。
adStatus	EventStatusEnum。 WillChangeRecordset が呼び出されたとき、イベントを発生させた操作が成功した場合、このパラメーターは adStatusOK に設定されます。 保留中の操作の取り消しをこのイベントが要求できない場合、このパラメーターは adStatusCantDeny に設定されます。 RecordsetChangeComplete が呼び出されたとき、このパラメーターは、イベントを発生させた操作が成功した場合は adStatusOK 、操作が失敗した場合は adStatusErrorsOccurred 、以前に受け付けた WillChangeRecordset イベントに関連付けられた操作が取り消された場合は adStatusCancel に設定されます。 WillChangeRecordset から制御が戻る前に、保留中の操作の取り消しを要求するには、このパラメーターを adStatusCancel に設定し、後続の通知が行われないようにするには、このパラメーターを adStatusUnwantedEvent に設定します。 WillChangeRecordset または RecordsetChangeComplete から制御が戻る前に後続の通知が行われないようにするには、このパラメーターを adStatusUnwantedEvent に設定します。
Perror	Error オブジェクトです。 adStatus の値が adStatusErrorsOccurred である場合に発生したエラーについて説明します。それ以外の場合は設定されません。
pRecordset	Recordset オブジェクト。 このイベントが発生した Recordset オブジェクトです。

注釈

WillChangeRecordset イベントまたは RecordsetChangeComplete イベントは、 Recordset の Requery メソッドまたは Open メソッドにより発生します。

プロバイダーがブックマークをサポートしていない場合、プロバイダーから新しい行が取得されるたびに RecordsetChange イベントの通知が発生します。 このイベントの発生頻度は、 RecordsetCacheSize プロパティによって決まります。

adReason パラメーターを含むすべてのイベントのイベント通知を完全に停止するには、考えられる adReason 値ごとに adStatus パラメーターを adStatusUnwantedEvent に設定する必要があります。