methods-on-a-form-data-source.md

---

title: Methods on a Form Data Source TOCTitle: Methods on a Form Data Source ms:assetid: ff683de9-bf37-4c00-87bc-13ab2fde9cc3 ms:mtpsurl: https://msdn.microsoft.com/en-us/library/Aa893931(v=AX.60) ms:contentKeyID: 35254215 ms.date: 05/18/2015 mtps_version: v=AX.60

Methods on a Form Data Source

Applies To: Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

Each form data source has a set of standard methods. You override these methods when you want to change the behavior for validation, caching, and so on. These methods are a subset of the methods in the FormDataSource system class.

You use the AOT to access the standard methods:

1. Expand the node for the form data source on the form.

2. Right-click the Methods node.

3. Select Override Method.

Note

Code written on forms cannot be re-used or inherited. If possible, write your code on the underlying table or in a class.

The following table lists the methods that are available for form data sources and explains when they are executed. For more information about each method, click the method name.

Method name	Executed when	Description
active	The user selects a new record.	Retrieves data from joined data sources when a user moves to a new record.
create	The user creates a new record in the data source.	Creates a new record in the data source. If you use this method to specify field values, the new values are saved to the database when you leave the form.
cursorNotify	Not run by the system.	Used to notify application code of table events.
defaultMark	The user clicks the mark area (uppermost left corner) in a grid control.	Sets the default mark value for records in a form.
deleted	The form data source record has been deleted.	Runs instead of the delete post-super for a form where the ChangeGroupMode property of the form Data Sources node is set to ImplicitInnerOuter.
delete	The user deletes a record in the data source.	Deletes the current record from the data source.
deleteMarked	The user deletes one or more marked (selected) records in the data source.	Deletes all marked (selected) records from a data source.
deleting	The form data source record is about to be deleted.	Runs instead of the delete pre-super for a form where the ChangeGroupMode property of the form Data Sources node is set to ImplicitInnerOuter.
displayOption	Activated before a record is displayed.	Sets the text color and the background color for a record in the data source.
executeQuery	The form is opened for data display.	Executes the data source query and displays the retrieved records.
filter	The user starts one of the Filter commands on the form shortcut menu.	Filters records in the data source.
findRecord	Activated by the findValue method.	Finds the specified record in the data source and makes it the current one.
findValue	The user clicks the Filter by Field command in the shortcut menu on a form control.	Finds the specified value in the data source and makes the record that has the specified value the current one by using the FormDataSource.findRecord method.
first	Focus moves to the first record in the data source.	Moves focus to the first record in the data source.
forceWrite	Executed when it is called.	Enables you to force a write operation on a record.
init	The form is opened.	Creates a data source query based on the data source properties.
initValue	A new record is created. The purpose is to fill in initial values in the record.	Initializes field values in a new record. If you use this method to specify field values, the new values are not automatically saved to the database when you leave the form. To specify values that you want to save when you leave the form, use the Create method.
last	Focus moves to the last record in the data source.	Moves focus to the last record in the data source.
leave	Focus moves to a new record or to a new data source.	Provides notification when focus is moved to the next record or moved to another data source.
leaveRecord	Focus moves to a new record.	Provides notification when focus moves to another record or another item on the form.
linkActive	The user selects a new record in a form that has a data source linked to another data source.	Calls the FormDataSource.exeuteQuery method on data sources that are linked to the current data source.
mark	A record in the data source is marked.	Enables you to mark a record in the data source.
markAllLoadedRecords	Not started by the system.	Enables you to mark or clear all the loaded records.
markChanged	One or more records in the data source are marked or unmarked.	Enables you to perform an action when there is a change to the number of marked records in the data source.
next	Focus moves to the next record in the data source.	Moves focus to the next record in the data source.
nextPage	The user requests the next page of data from the data source.	Moves a specified number of records forward in the data source. Pulls the next page of data.
prev	Focus moves to the previous record in the data source.	Moves focus to the previous record in the data source.
prevPage	The user requests the previous page of data from the data source.	Moves focus back by a specified number of records in the data source. Pulls the previous page of data.
print	The user starts the Print command in the File menu.	Prints the current record.
prompt	The user starts the Advanced Filter/Sort command (either from the Edit > Filter menu or by pressing CTRL+F3).	Activates SysQueryForm, which is the standard form used to limit a query range.
refresh	Not started by the system.	Updates the form by refreshing the view of all records in the data source.
refreshEx	A form is opened where records have been selected.	Refreshes the view of the specified records.
removeFilter	The user clicks the Remove Filter/Sort command in the shortcut menu on a form control.	Resets the query for the data source.
reread	Not started by the system.	Rereads the current record from the database.
rereadReferenceDataSources	The value of a foreign key field is programmatically changed.	Used to update the joined referenced data source for the current record when the foreign key field is programmatically changed.
research	Not started by the system.	Refreshes the database search defined by the query, specified by the FormDataSource.init method.
selectionChanged	The user selects or unselects one or more records in the data source.	Enables you to change the property values of control when the selected record changes.
validateDelete	The user has chosen to delete a record.	Requests the user to confirm the deletion of a record from the data source.
validateWrite	A new or updated record is to be written.	Determines whether data is valid and ready to be written.
write	The user inserts a new record or updates an existing one.	Calls the FormDataSource.validateWrite method and manages the database write operation.
writing	The form data source record is about to be saved to the database.	Runs instead of the write pre-super for a form where the ChangeGroupMode property of the form Data Sources node is set to ImplicitInnerOuter.
written	The form data source record has been saved to the database.	Runs instead of the write post-super for a form where the ChangeGroupMode property of the form Data Sources node is set to ImplicitInnerOuter.

See also

FormDataSource Class

Methods on a Form

Methods on Form Controls

Announcements: New book: "Inside Microsoft Dynamics AX 2012 R3" now available. Get your copy at the MS Press Store.