| True DataControl 8.0 Reference > True DataControl Control > TData Control Events > RecordsetChangeComplete Event |
RecordsetChangeComplete Event
Occurs after the whole recordset has changed.
TData_RecordsetChangeComplete (ByVal adReason As EventReasonEnum, ByVal pError As ADODB.Error, adStatus As EventStatusEnum)
Arguments: adReason is an ADO EventReasonEnum value. Specifies the reason for this event. Its value can beadRsnReQuery, adRsnReSynch, adRsnClose, adRsnOpen.
pError is an ADO Error object. It describes the error that occurred if the value of adStatus is adStatusErrorsOccurred; otherwise it is not set.
adStatus is an ADO EventStatusEnum status variable. When RecordsetChangeComplete is called, this parameter is set toadStatusOK if the operation that caused the event was successful, adStatusErrorsOccurred if the operation failed, or adStatusCancel if the operation associated with the previously accepted WillChangeRecordset event has been canceled.
The RecordsetChangeComplete event is a standard ADO Recordset event fired by the TData control’s Recordset. For more information, see Using recordset events. As with any ADO recordset, this event occurs after the whole contents of the recordset change due to a pending operation. It is also fired when an operation has attempted to change the recordset, and failed. This case can be detected by the value of the adStatus argument, it is set to adStatusErrorsOccurred if the operation failed.
The RecordsetChangeComplete event may occur due to the following Recordset operations: Requery, Resync, Close, Open, and Filter.
See Also