Contents Index CreateDatabase method DropDatabase method

UltraLite for MobileVB User's Guide
  UltraLite for MobileVB API Reference
    ULDatabaseManager class

CreateDatabaseWithParms method


CreateDatabaseWithParms creates a new database using a connection parameter object, and returns a connection to it.

Prototype 

CreateDatabaseWithParms( parms As ULConnectionParms ) As ULConnection
Member of UltraLiteAFLib.ULDatabaseManager

Description 

Creates a new database and returns a connection to it. It fails if the specified database already exists. A valid schema file must be specified to successfully create a database. To alter the schema of an existing database, use the ULDatabaseSchema.ApplyFileWithParms method.

Caution  
Only one database may be active at a given time. Attempts to create a different database while other connections are open will result in an error.
Parameters 

parms    A ULConnectionParms object that holds a set of connection parameters.

Note for VFS card for Palm users  
You specify VFSOnPalm in the ULConnectionParms interface.

For more information about the Palm_fs parameter, see palm_fs parameter .

Returns 

Returns a connection to a newly created UltraLite database. Fails if the specified database already exists.

Examples 

The following example assumes you have placed the ULConnectionParms object on your form, named it LoginParms and have specified the database locations and schema locations in the Connection parms properties window.

The following code creates a ULDatabaseManager object. This is the first object you create when writing for UltraLite for MobileVB.

Note that CreateDatabaseWithParms requires that no .udb file exists, and OpenConnectionWithParms is used when a .udb file already exists.

DatabaseMgr.DropDatabaseWithParms LoginParms
Set Connection = DatabaseMgr.CreateDatabaseWithParms(LoginParms)

Contents Index CreateDatabase method DropDatabase method