Export (0) Print
Expand All
Expand Minimize

xRecord.skipEvents Method

Provides an option to turn off calling the Application.event* methods for the lifetime of an instance of the xRecord instance.


public boolean skipEvents([boolean newValue])

Called

Parameter

Description

newValue

A Boolean value that indicates whether to skip events.

true if events are skipped; otherwise, false.

This method resembles the skipDatabaseLog method.

This method is also used internally in the kernel in order to skip events that make no sense to generate; this is consistent with the behavior of the skipDatabaseLog method in the following methods:

  • The Application.deleteCompany method: Event generation is turned off for the duration of a company delete operation. This is an admin operation and it could be very expensive performance wise to support events in this case.

  • The SqlDataDictionary.tableDelete method: Event generation is turned off for the duration of a table delete. This is an admin operation and it could be very expensive performance wise to support events in this case.

  • The RecordInsertList class, which implements array insert capabilities in the kernel, takes an optional argument, _skipEvents = FALSE, in the new method that will conditionally skip events, as specified by a developer. Even if events are not skipped this will not make the kernel rewrite the SQL.

  • When a primary key is renamed, event generation is turned off for the duration of the rename operation. This includes a primary key in one record and can include a foreign key in many records. After the rename operation, the eventRenameKey method is called.

Community Additions

ADD
Show:
© 2015 Microsoft