True DataControl 8.0 Reference > True DataControl Control > TData Control Events > WillChangeRecordset Event |
WillChangeRecordset Event
Occurs before the whole contents of the recordset change due to a pending operation.
TData_WillChangeRecordset (ByVal adReason As EventReasonEnum, adStatus As EventStatusEnum)
Arguments: adReason is an ADO EventReasonEnum value. Specifies the reason for this event. Its value can beadRsnReQuery, adRsnReSynch, adRsnClose, adRsnOpen.
adStatus is an ADO EventStatusEnum status variable. When WillChangeRecordset is called, this parameter is set to adStatusOK ,or to adStatusCantDeny, the latter means that this event cannot request cancellation of the pending operation. Before WillChangeRecordset returns, set this parameter to adStatusCancel to request cancellation of the operation that caused this event.
The WillChangeRecordset 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 before the whole contents of the recordset change due to a pending operation.
The WillChangeRecordset event may occur due to the following Recordset operations: Requery, Resync, Close, Open, and Filter.
See Also