Set Database File Property

You can use setProperty to specify the database file name on the device, such as the directory of the running program, a specific directory path, or a secure digital (SD) card.

ConnectionProfile cp = MyDatabaseClass.getConnectionProfile();
cp.setProperty("databaseFile", "databaseFile");
cp.save();

Examples

If you specify the databaseFile name only, with no path, the databaseFile is created in the path where the program is running:
/mydb.udb
The databaseFile is created in the /Temp directory of the Windows Mobile device:
/Temp/mydb.udb
The databaseFile is created on an SD card:
/Storage Card/mydb.udb
Note: For the database file path and name, the forward slash (/) is required as the path delimiter, for example /smartcard/supprj.udb.

Usage

  • Be sure to call this API before the database is created:
    • Call this API before calling LoginToSync().
  • The database is UltraLite; use a database file name like mydb.udb.
  • If the device client user changes the file name, the device user must make sure the input file name is a valid name and path on the client side.