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

イベントは、保留中の操作によってレコードセット内の1つまたは複数のフィールドオブジェクトの値が変更される前に呼び出されます。The WillChangeField event is called before a pending operation changes the value of one or more Field objects in the Recordset. FieldChangeCompleteイベントは、1つまたは複数のフィールドオブジェクトの値が変更された後に呼び出されます。The FieldChangeComplete event is called after the value of one or more Field objects has changed.

構文Syntax

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

パラメーターParameters

cFieldscFields
フィールド内のフィールドオブジェクトの数を示すLongです。A Long that indicates the number of Field objects in Fields.

フィールドFields
Changefieldの場合、 Fieldsパラメーターは、元の値を持つFieldオブジェクトを含むvariantの配列です。For WillChangeField, the Fields parameter is an array of Variants that contains Field objects with the original values. FieldChangeCompleteの場合、 Fieldsパラメーターは、値が変更されたフィールドオブジェクトを含むvariantの配列です。For FieldChangeComplete, the Fields parameter is an array of Variants that contains Field objects with the changed values.

pErrorpError
エラーオブジェクトです。An Error object. Adstatusの値がadstatuserrorている場合に発生したエラーについて説明します。それ以外の場合は設定されません。It describes the error that occurred if the value of adStatus is adStatusErrorsOccurred; otherwise it is not set.

adStatusadStatus
Eventstatusenum状態の値です。An EventStatusEnum status value.

呼び出されたときに 、イベントを発生させた操作が成功した場合、このパラメーターは adstatusok に設定されます。When WillChangeField is called, this parameter is set to adStatusOK if the operation that caused the event was successful. このイベントが保留中の操作の取り消しを要求できない場合は、 Adstatuscantdeny に設定されます。It is set to adStatusCantDeny if this event cannot request cancellation of the pending operation.

FieldChangeCompleteが呼び出されると、このパラメーターは、イベントの原因となった操作が成功した場合はadstatusokに、操作が失敗した場合はAdstatuserror curredに設定されます。When FieldChangeComplete is called, this parameter is set to adStatusOK if the operation that caused the event was successful, or to adStatusErrorsOccurred if the operation failed.

Changefieldが返される前に、このパラメーターをadstatuscancelに設定して、保留中の操作の取り消しを要求します。Before WillChangeField returns, set this parameter to adStatusCancel to request cancellation of the pending operation.

FieldChangeCompleteが返される前に、このパラメーターをadStatusUnwantedEventに設定して、後続の通知が行われないようにします。Before FieldChangeComplete returns, set this parameter to adStatusUnwantedEvent to prevent subsequent notifications.

pRecordsetpRecordset
レコードセットオブジェクトです。A Recordset object. このイベントが発生した レコードセットThe Recordset for which this event occurred.

解説Remarks

Valueプロパティを設定しFieldChangeComplete 、フィールドと値の配列パラメーターを使用してUpdateメソッドを呼び出すと、が発生する可能性があります。A WillChangeField or FieldChangeComplete event may occur when setting the Value property and calling the Update method with field and value array parameters.

参照See Also

ADO Events モデルの例 (VC + +) ADO Events Model Example (VC++)
ADO イベント ハンドラーの概要ADO Event Handler Summary