WillChangeField および FieldChangeComplete イベント (ADO)

  • [アーティクル]

WillChangeField イベントは、保留中の操作が Recordset 内の 1 つ以上の Field オブジェクトの値を変更する前に呼び出されます。 FieldChangeComplete イベントは、1 つ以上の Field オブジェクトの値が変更された後に呼び出されます。

構文

  
WillChangeField cFields, Fields, adStatus, pRecordset  
FieldChangeComplete cFields, Fields, pError, adStatus, pRecordset

パラメーター

cFields
Fields 内の Field オブジェクトの数を示す Long。

Fields
WillChangeField の場合、Fields パラメーターは、元の値を含む Field オブジェクトが含まれている Variants の配列です。 FieldChangeComplete の場合、Fields パラメーターは、変更された値を含む Field オブジェクトが含まれている Variants の配列です。

pError
Error オブジェクト。 adStatus の値が adStatusErrorsOccurred の場合に発生したエラーの説明です。それ以外の場合は設定されません。

adStatus
EventStatusEnum の状態値。

WillChangeField が呼び出されると、イベントの原因となった操作が成功した場合にこのパラメーターは adStatusOK に設定されます。 このイベントが保留中の操作の取り消しを要求できない場合は、adStatusCantDeny に設定されます。

FieldChangeComplete が呼び出されると、イベントの原因となった操作が成功した場合はこのパラメーターが adStatusOK に設定され、操作が失敗した場合は adStatusErrorsOccurred に設定されます。

WillChangeField が戻る前に、このパラメーターを adStatusCancel に設定すると、保留中の操作の取り消しが要求されます。

FieldChangeComplete が戻る前に、このパラメーターを adStatusUnwantedEvent に設定すると、以降の通知が行われなくなります。

pRecordset
Recordset オブジェクト。 このイベントが発生した Recordset。

注釈

Value プロパティを設定し、フィールドおよび値配列のパラメーターを指定して Update メソッドを呼び出すと、WillChangeField または FieldChangeComplete イベントが発生することがあります。

参照

ADO イベント モデルの例 (VC++)
ADO イベント ハンドラーの概要