Names the new database file when creating a database. When opening a connection to an existing database, the parameter identifies the database.

Syntax

NT_FILE=path\nt-db

Default

Remarks

You should use the NT_FILE connection parameter for UltraLite client applications that use the same connection string to connect to a desktop database, as well as a database on other platforms.

This connection parameter takes precedence over the DBF parameter. If you are connecting from an UltraLite administration tool, or your connection object only connects to a desktop database, use the DBF connection parameter.

The value of NT_FILE must meet the file name requirements for Windows desktop platforms.

The path can be absolute or relative. If you include a directory as part of the file name, then all directories must exist before setting the path to this file. UltraLite does not create them automatically.

Any leading or trailing spaces in parameter values are ignored. This connection parameter's value cannot include leading single quotes, leading double quotes, or semicolons.

See also

• Opening UltraLite connections with connection strings
• Specifying file paths in an UltraLite connection parameter
• Precedence of connection parameters for UltraLite administration tools
• UltraLite DBF connection parameter
• UltraLite for C/C++: Connecting to a database
• UltraLite for C/C++: OpenConnection function
• UltraLite for embedded SQL: Connecting to a database
• UltraLite for M-Business Anywhere: Connecting to an UltraLite database
• UltraLite for M-Business Anywhere: openConnection method
• UltraLite.NET: Connecting to a database
• UltraLite.NET: Open method

Example

The following example creates a new connection and identifies different database files for the desktop, Palm OS, and Windows Mobile platforms:

Connection = DatabaseMgr.OpenConnection("UID=JDoe;PWD=ULdb;
NT_FILE=c:\test\MyTestDB.udb;CE_FILE=\database\MyCEDB.udb;PALM_FILE=MyPalmDB_MyCreatorID")