CREATEDATABASE |
Crée une base de données |
| Visual Basic |
Syntaxe
|
Set database = CreateDatabase(databasename, locale [, options])
|
Paramètres
| Nom |
Description |
| database |
Ce paramètre permet d'indiquer une variable d'un type de données objet représentant l'objet Database que vous créez. |
| workspace |
Ce paramètre permet d'indiquer une variable d'un type de données d'objet représentant l'objet Workspace existant contenant la base de données. Si vous omettez la partie d'espace de travail, l'espace
de travail par défaut est utilisé. |
| databasename |
Ce paramètre permet d'indiquer une expression de chaîne de caractères correspondant au nom du fichier de base de données que vous créez. Il peut s'agir du chemin complet et du nom de fichier, par
exemple "C:\MYDB.MDB". Si vous ne fournissez pas d'extension de nom de fichier, .MDB est ajouté. Si votre réseau le prend en charge, vous pouvez également spécifier un chemin d'accès réseau, tel
que "\\MYSERVER\MYSHARE\MYDIR\MYDB". Seuls les fichiers de base de données .MDB peuvent être créés à l'aide de cette méthode. |
| locale |
Ce paramètre permet d'indiquer une expression de chaîne de caractères utilisée pour spécifier l'ordre de classement pour la création de la base de données. Vous devez fournir ce paramètre ou une erreur
se produira. |
| options |
Ce paramètre permet d'indiquer un entier indiquant une ou plusieurs options, comme spécifié dans Settings. Vous pouvez combiner des options en additionnant les constantes correspondantes. |
Description
Cette fonction de créer une nouvelle base de données Microsoft Jet, enregistre la base de données sur le disque, crée un nouvel objet Database et renvoie un objet Database ouvert pour un accès exclusif en lecture/écriture.
Remarques
- La fonction CreateDatabase est incluse pour la compatibilité avec les versions antérieures. Il est recommandé d'utiliser la méthode CreateDatabase avec l'objet Workspace à la place. La
fonction CreateDatabase et la méthode CreateDatabase ont des parties, paramètres et fonctions identiques.
- La fonction CreateDatabase permet de créer une nouvelle base de données Microsoft Jet au format .MDB, directement depuis une application
Visual Basic. Cela facilite l'automatisation de la création de structures de données sans intervention manuelle via Access.
Elle est utile dans les applications qui nécessitent de générer dynamiquement des fichiers de base de données.
- Le paramètre databasename est fondamental car il détermine le nom et l'emplacement de la base de données à créer. Si l'utilisateur n'indique pas d'extension,
.MDB est automatiquement ajoutée. Cela garantit une compatibilité immédiate avec les outils Microsoft Access
tout en évitant des erreurs de fichier manquant ou mal formaté.
- Le paramètre locale est requis et indique l'ordre de classement utilisé pour la nouvelle base. Cette information est cruciale pour la gestion des chaînes de
caractères, notamment pour le tri et la recherche. Omettre ce paramètre entraîne une erreur, soulignant son caractère obligatoire dans la syntaxe de la fonction.
- Le paramètre options permet de spécifier des caractéristiques supplémentaires pour la base, comme son chiffrement ou ses compatibilités spécifiques avec certaines
versions d'Access. Ces options sont définies sous forme de constantes et peuvent être combinées pour obtenir le comportement souhaité. Cela offre une personnalisation
avancée dès la création.
- La fonction CreateDatabase retourne un objet Database ouvert en lecture/écriture, ce qui permet d'interagir immédiatement avec la base nouvellement
créée. Cela rend son intégration dans un flux de travail automatisé plus fluide, car aucune opération d'ouverture supplémentaire n'est nécessaire après la création.
- Même si cette fonction est encore disponible pour assurer la compatibilité avec d'anciennes versions de Visual Basic, il est conseillé d'utiliser la version
CreateDatabase de l'objet Workspace pour les nouveaux projets. Cette approche orientée objet offre une meilleure structure, plus de souplesse, et s'intègre
mieux aux architectures modernes.
- Le paramètre workspace peut être omis, auquel cas la base est créée dans l'espace de travail par défaut. Cependant, pour des applications complexes ou
multi-utilisateurs, il peut être préférable de spécifier un espace de travail explicite pour mieux gérer les connexions et les accès concurrents à la base de données.
- L'usage de CreateDatabase est particulièrement pertinent dans des contextes où l'utilisateur final ne doit pas manipuler les bases de données directement,
comme dans des logiciels embarquant des assistants de configuration ou des solutions de gestion autonomes. Il permet une génération contrôlée et sécurisée de
l'environnement d'entreposage dès l'installation ou la première utilisation.
Dernière mise à jour : Mercredi, le 30 Décembre 2020
