|
TLiteBackup.Backup Method |
|
|
|
TLiteBackup.Backup Method |
|
Starts the backup process
procedure Backup;
Use the method to starts the process of copying the source database into the destination database.
Before starting the backup process, the connection to the source database has to be specified in the SourceConnection property, and the source database name in the SourceDatabaseName property. The connection to the destination database has to be specified in the DestinationConnection property, and the destination database name in the DestinationDatabaseName property.
Both source and destination connection have to be connected to perform a backup. Otherwise, the appropriate exception will be raised.
When the backup is started, the backup mechanism tries to copy up to PagesPerStep database pages between the source and destination databases. If there are still more pages to be copied, then the OnProgress event is triggered, and the backup process continues. Otherwise, the backup process is finished.
When during the backup process the source database becomes locked by an outside connection, then if the WaitWhenLocked property is set to True, the backup process waits for WaitDelay milliseconds until WaitTimeout is reached. If the source database lock is released, the backup process continues. Otherwise, the appropriate exception is raised.