Xojo Documentation Xojo Documentation

Method

Database.RollbackTransaction()

New in 2019r2

Supported for all project types and targets.

Cancels an open transaction restoring the database to the state it was in before the transaction began.

Notes

You will generally want to rollback database changes if a DatabaseException occurs within the transaction.

You have to have an open transaction to be able to use Rollback. On SQLite (and other databases), you can start a transaction with this command:

BEGIN TRANSACTION

It can be sent using ExecuteSQL:

db.ExecuteSQL("BEGIN TRANSACTION")

Sample Code

This code uses rollback to revert database changes in a transaction when an error occurs:

// Prior DB code has run

Try
db.CommitTransaction
Catch error As DatabaseException
MessageBox("Error: " + error.Message)
db.RollbackTransaction
End If

See Also

Database.Close, Database.CommitTransaction