CreateDatabase-Methode

public static ULConnection * CreateDatabase(
    const char * connParms,
    const char * createParms,
    ULError * error
)

connParms Eine durch Semikola getrennte Zeichenfolge von Verbindungsparametern, die in der Form von Schlüsselwort=Wert-Paaren festgelegt werden. Die Verbindungszeichenfolge muss den Namen der Datenbank enthalten. Es handelt sich um dieselben Parameter, die beim Herstellen der Verbindung mit einer Datenbank angegeben werden können.
createParms Eine durch Semikolons getrennte Zeichenfolge von Datenbankerstellungsparametern, die in der Form von Schlüsselwort-Wert-Paaren angegeben werden. Zum Beispiel: page_size=2048;obfuscate=yes.
error Ein optionales ULError-Objekt für die Aufnahme der Fehlerinformationen.

Ein ULConnection-Objekt für die neue Datenbank wird zurückgegeben, wenn die Datenbank erfolgreich erstellt wurde. NULL wird zurückgegeben, wenn die Methode fehlschlägt. Ein Fehler wird gewöhnlich durch einen ungültigen Dateinamen oder durch eine Verweigerung des Zugriffs verursacht.

Die Datenbank wird mit Informationen erstellt, die in zwei Parametergruppen bereitgestellt werden.

Der connParms-Parameter ist eine Gruppe von Standard-Verbindungsparametern, die immer anwendbar sind, wenn auf die Datenbank zugegriffen wird, z.B. Dateiname oder Chiffrierschlüssel.

Der createParms-Parameter ist eine Gruppe von Parametern, die nur zum Zeitpunkt der Datenbankerstellung relevant sind, z.B. Prüfsummenebene, Seitengröße, Kollation sowie Uhrzeit- und Datumsformat.

Der folgende Code zeigt, wie Sie die CreateDatabase-Methode verwenden, um eine UltraLite-Datenbank mit dem Dateinamen mydb.udb zu erstellen:

ULConnection * conn;
conn = ULDatabaseManager::CreateDatabase( "DBF=mydb.udb", "checksum_level=2" );
if( conn != NULL ) {
    // success
} else {
    // unable to create
}

CreateDatabase-Methode

Syntax

Parameter

Rückgabe

Bemerkungen

Siehe auch