Data Source Events

This list contains USoft-specific events that occur in the context of data source objects.

The -pre- events are mainly used to prevent, under specific circumstances, that the operation is executed. The -post- events are mainly used to add custom processing to the operation.

If the operation(s) you are coding is (are) closely associated with a UI control, you may prefer to add these events to a control associated with the data source, rather than to the data source object itself. This has advantages for code maintainability. In this case, the control will propagate the event handling to the data source. The effect will be the same in both cases, except that any occurrence of the 'this' keyword will refer to the UI control in one case and to the data source in the other.

Event	Occurs when
beforecleardataset	Before a dataset is cleared.
beforeexecutequery	Before the data source is queried. See also the before... and rowpre... events help topic. In default applications, users can query by pressing the Search button. To query programmatically, use the executeQuery() function of the DataSourceContainer object.
beforegotodataset	When navigation to a different dataset takes place. See also the before... and rowpre... events help topic. In default applications, users can navigate to a different dataset using the special DataSetNumbers control offered in each data page. To navigate programmatically, call the gotoDataSet() function of the DataSourceContainer object.
beforerefresh	Before the data source is refreshed. See also the before... and rowpre... events help topic. To refresh the data source programmatically, call the refresh() function of the DataSourceContainer object.
colpreupdate	Before a value in a column is updated.
colpostupdate	After a value in a column is updated.
dataset	When data is received for one or more data sources.
ongetdataset	This event has been replaced by the dataset event and is supported for backward compatibility only.
onselectrow	This event has been replaced by the rowselect event and is supported for backward compatibility only.
rowpostcreate	After a record is created.
rowpostdelete	After a record is deleted.
rowpostrefresh	After a record is refreshed.
rowpostselect	After a record is selected (whether or not selection was successful).
rowpostupdate	After a record is updated.
rowprecreate	Before a record is created. See also the before... and rowpre... events help topic.
rowpredelete	Before a record is deleted. See also the before... and rowpre... events help topic.
rowprerefresh	Before a record is refreshed. See also the before... and rowpre... events help topic.
rowpreselect	After the currently selected record has changed, and before selection happens. See also the before... and rowpre... events help topic.
rowpreupdate	Before a record is updated. See also the before... and rowpre... events help topic.
rowquery	Before row selection changes to a different row.
rowselect	When the currently selected row changes.
showdata	Notifies controls on the page that new data is available for display. This event is for advanced developers who are creating control factories.