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

WillChangeField保留中の操作が 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
A長いの数を示すフィールドオブジェクトフィールドします。A Long that indicates the number of Field objects in Fields.

FieldsFields
WillChangeFieldフィールドパラメーターが配列のバリアントを格納しているフィールド元の値を持つオブジェクト。For WillChangeField, the Fields parameter is an array of Variants that contains Field objects with the original values. FieldChangeCompleteフィールドパラメーターが配列のバリアントを格納しているフィールド値が変更されたオブジェクト.For FieldChangeComplete, the Fields parameter is an array of Variants that contains Field objects with the changed values.

pErrorpError
エラーオブジェクト。An Error object. 場合に発生したエラーを説明の値adStatusadStatusErrorsOccurred; 未設定がそれ以外の場合。It describes the error that occurred if the value of adStatus is adStatusErrorsOccurred; otherwise it is not set.

adStatusadStatus
EventStatusEnum状態値。An EventStatusEnum status value.

ときにWillChangeFieldが呼び出されると、このパラメーターを設定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イベントの原因となった操作が成功した場合またはadStatusErrorsOccurred場合操作に失敗しました。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.

前にWillChangeField戻り値は、このパラメーターに設定する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オブジェクト。A Recordset object. Recordsetのこのイベントが発生しました。The Recordset for which this event occurred.

コメントRemarks

A WillChangeFieldまたは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 イベント モデルの例 (vc++) ADO Events Model Example (VC++)
ADO イベント ハンドラーの概要ADO Event Handler Summary