[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] Reference for unit 'SQLDB' (#fcl)

TSQLQuery.Options

Options controlling the behaviour of the dataset

Declaration

Source position: sqldb.pp line 703

published property TSQLQuery.Options : TSQLQueryOptions;

Description

Options controls the behaviour of the dataset. The following options can be specified:

sqoKeepOpenOnCommit
The default SQLDB behaviour is to close all datasets connected to a transaction when a transaction is committed or rolled back, which means that transactions must remain active as long as the dataset is open. This can create problems with locking of records etc. With this option set, the dataset will be kept open. Note that setting this option will cause SQLDB to fetch all records in the result set in memory.
sqoAutoApplyUpdates
Setting this option will make TSQLQuery call ApplyUpdates after every Post or Delete operation.
sqoAutoCommit
Setting this option will make TSQLQuery call commit after every ApplyUpdates
sqoCancelUpdatesOnRefresh
Setting this option will cause TSQLQuery to abandon all pending changes when Refresh is called. The default behaviour is to raise an exception when Refresh is called and there are pending changes
sqoPreferRefresh
If the database engine supports RETURNING, then the returning mechanism is used to fetch field values after an update of the database. Setting this option will disable the use of RETURNING and will fetch updated or new values instead with the TSQLQuery.RefreshSQL property or a constructed refresh SQL statement.

See also

TCustomSQLQuery.ApplyUpdates

  

Apply updates and check result

TCustomSQLQuery.Post

  

Post pending changes and optionally apply updates

TCustomSQLQuery.Delete

  

Delete and optionally apply updates


Documentation generated on: May 14 2021