连接到 UltraLite 数据库

使用 ULDatabaseManager 对象创建或连接到名为 sample.udb 的 UltraLite 数据库。

前提条件

执行此任务没有前提条件。

任务

使用以下代码初始化 ULDatabaseManager 对象和启用 UltraLite 中的功能：

if( !ULDatabaseManager::Init() ) {
    return 0;
}
ULDatabaseManager::EnableAesDBEncryption();
 
// Use ULDatabaseManager.Fini() when terminating the app.

使用以下代码，打开与现有数据库的连接，或者，如果指定的数据库文件不存在，创建一个新数据库：

ULConnection * conn;
ULError ulerr;
 
conn = ULDatabaseManager::OpenConnection( "dbf=sample.udb;dbkey=aBcD1234", &ulerr );
if( conn == NULL ) {
    if( ulerr.GetSQLCode() == SQLE_ULTRALITE_DATABASE_NOT_FOUND ) {
        conn = ULDatabaseManager::CreateDatabase( "dbf=sample.udb;dbkey=aBcD1234", &ulerr );
        if( conn == NULL ) {
            // write code that uses ulerr to determine what happened
            return 0;
        }
        // add code to create the schema for your database
    } else {
        // write code that uses ulerr to determine what happened
        return 0;
    }
}
assert( conn != NULL );

在此步骤中，万一连接不成功，则声明包含错误信息的 ULError 对象。

结果

已与 sample.udb 数据库建立连接。

使用DocCommentXchange讨论此页。