WillChangeField 和 FieldChangeComplete 事件 (ADO)

會在暫止作業變更 Recordset 中的一或多個 Field 物件值之前呼叫 WillChangeField 事件。 FieldChangeComplete 事件會在一或多個 Field 物件的值變更之後呼叫。

語法

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

參數

cFields
Long，表示 Fields 中的 Field 物件數目。

欄位
對於 WillChangeField，Fields 參數是 Variants 的陣列，其中包含具有原始值的 Field 物件。 對於 FieldChangeComplete，Fields 參數是 Variants 的陣列，其中包含具有變更值的 Field 物件。

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 事件處理常式摘要