procedure Insert(Append: Boolean=False)

Usage

Available In: Client and Server Applications

Use this method to begin inserting a new row in the dataset. If the Append parameter is True, then the new row will be appended to the end of the dataset, and if the Append parameter is False, then the new row will be inserted at the active row position in the dataset. Before the insert occurs, the BeforeInsert event is triggered, allowing the insertion to be aborted, if necessary. The OnInitRow event is then triggered to allow the new row to be initialized without flagging the row as being modified. After the insertion occurs, the AfterInsert event is triggered.

Use the Save method to complete the insertion of the new row.