The .NET event published when record batching is enabled (that is, the BindingSource object's Batching property is TRUE) and some user action in the bound .NET control reaches the last row of the current result set. Use this event to retrieve the next batch of records.
You can use this event when the BindingSource object is bound to a query. If bound to a ProDataSet object, this event applies only to the top-level table displayed in the .NET control.
The delegate for this event defines the following event handler signature:
EventHandlerName (
INPUT sender AS CLASS System.Object,
INPUT args AS CLASS Progress.Data.OffEndEventArgs
).
EventHandlerName
The name of the event handler.
sender
Object reference to the BindingSource object instance that published the event.
args
Object reference to an OffEndEventArgs object instance containing arguments for the event.
Each time you retrieve a batch of records, you must:
Add the records to the current result set.
Set the RowsAdded property for the OffEndEventArgs object to the number of records added to the result set (that is, the number of records retrieved in the most recent batch).
Once you have retrieved all of the records, set the Batching property to FALSE.
Add the records to the current result set.