iAnywhere.com - Méthode Open

Méthode Open

Prototype

bool Open ()

bool Open( SQLCA* ca )

bool Open( ul_char* parms )

bool Open( SQLCA* ca , ul_char* parms )

Prépare l'application afin qu'elle fonctionne avec une base de données. Vous devez ouvrir l'objet ULData avant toute opération sur la base de données via l'API C++. Les exceptions à cette règle sont les suivantes :

Sur la plate-forme Palm Computing, la méthode ULData.PalmLaunch est appelée avant ULData.Open. Les ressources requises par cette bibliothèque pour votre programme sont allouées et initialisées sur cet appel.

Sur la plate-forme Palm Computing, appelez ULData.Open chaque fois que ULData.PalmLaunch renvoie LAUNCH_SUCCESS_FIRST. Pour plus d'informations, reportez-vous à la section Méthode PalmLaunch [déconseillée].
Les fonctions qui configurent le stockage des bases de données peuvent être appelées. Ces fonctions possèdent des noms commençant par ULEnable.

Vous pouvez spécifier des paramètres de stockage permanent lors de l'ouverture d'une base de données pour configurer la mise en mémoire cache, le cryptage et le nom de fichier de la base. Pour plus d'informations sur ces paramètres, reportez-vous au chapitre Définition de propriétés de base de données UltraLite.

Pour les applications multithread, chaque thread doit ouvrir son propre objet ULData. Ni l'objet ULData, ni les autres objets hérités de celui-ci (ULConnection et autres classes) ne peuvent être partagés entre threads.

Paramètres

Open( ) Cette syntaxe peut être utilisée par la plupart des applications UltraLite. Tous les paramètres de stockage permanent définis dans la macro UL_STORE_PARMS sont utilisés lors de l'ouverture de la base de données.

Open( SQLCA* ca ) Employez cette syntaxe si vous utilisez Embedded SQL et l'API C++ dans votre application, ainsi qu'une zone SQLCA pour accéder aux mêmes données via l'API C++.

Open( ul_char* parms ) Vous pouvez définir des paramètres de stockage permanent à l'aide de la macro UL_STORE_PARMS. Cette syntaxe constitue une autre méthode pour définir des paramètres de stockage permanent. La chaîne comprend une liste d'affectations séparées par des points-virgules, sous la forme paramètre=valeur.

Open( SQLCA *ca, ul_char* parms ) Appel spécifiant à la fois la zone SQLCA et les paramètres de stockage permanent.

Pour plus d'informations sur les paramètres de stockage permanent, reportez-vous à la section Macro UL_STORE_PARMS.

Valeur renvoyée

true (1) si la méthode a abouti.

false (0) si la méthode a échoué.

Exemple

L'exemple suivant illustre la déclaration et l'ouverture d'un objet ULData :

ULData db;
db.Open();

Voir aussi

Méthode Close

Définition de propriétés de base de données UltraLite