CURDIR |
Chemin courant |
|---|---|
| Access 2019, Access 2016, Access 2013, Access 2010, Access 2007, Access 2003, Access XP, Access 2000 | Microsoft Access |
Syntaxe
| CurDir(drive) |
Paramètres
| Nom | Description |
|---|---|
| drive | Ce paramètre optionnel permet d'indiquer l'unité de disque courant. Si ce paramètre est omis, la fonction «CurDir» utilisera l'unité courante. |
Description
Cette fonction permet de demander le répertoire courant.
Remarques
- La fonction retourne le répertoire de travail courant : La fonction CurDir permet d'obtenir le chemin du répertoire courant utilisé par le système d'exploitation. Ce chemin est retourné sous la forme d'une chaîne de caractères. Il est souvent utilisé pour construire des chemins de fichiers relatifs sans avoir à connaître leur emplacement absolu.
- Le paramètre représentant le lecteur est facultatif : Le paramètre drive est optionnel et permet de demander le répertoire courant d'un lecteur particulier. Si ce paramètre est omis, CurDir retourne simplement le répertoire courant du lecteur actif. Cette flexibilité permet de travailler facilement avec plusieurs unités d'entreposage.
- La fonction retourne une chaîne de caractères : Le résultat de CurDir est toujours une valeur de type String. Cette chaîne peut être affichée, enregistrée dans une variable ou concaténée avec un nom de fichier afin de construire un chemin complet. Elle peut également être utilisée dans des messages destinés à l'utilisateur.
- Elle est fréquemment utilisée pour accéder à des fichiers : Lorsqu'une application doit ouvrir ou enregistrer un fichier dans le répertoire courant, CurDir permet de récupérer rapidement cet emplacement. Il devient alors facile de construire un chemin complet, par exemple en ajoutant "\rapport.txt" ou "\Donnees.accdb" au résultat retourné. Cette approche évite de coder des chemins fixes dans l'application.
- Le répertoire courant peut être modifié pendant l'exécution : Le résultat retourné par CurDir n'est pas nécessairement toujours le même. Une instruction telle que ChDir ou certaines boîtes de dialogue d'ouverture de fichiers peuvent modifier le répertoire courant de l'application. Il est donc préférable d'appeler CurDir au moment où l'information est réellement nécessaire plutôt que de supposer qu'elle n'a pas changé.
- La fonction ne retourne pas le dossier où se trouve la base de données Access : Il est important de distinguer le répertoire courant du dossier contenant le fichier .accdb ou .mdb. Si l'objectif est de connaître l'emplacement de la base de données ouverte, il est généralement préférable d'utiliser CurrentProject.Path. CurDir reflète uniquement le répertoire de travail actuel du processus.
- Elle est disponible dans le code VBA et dans les expressions Access : La fonction CurDir peut être utilisée dans les modules VBA, mais également dans certaines expressions employées dans les formulaires ou les états. Elle est particulièrement utile lors de procédures d'importation, d'exportation ou de génération de fichiers. Son utilisation évite de devoir saisir manuellement le chemin du dossier courant.
- Elle est souvent utilisée avec les fonctions ChDir et MkDir : CurDir est fréquemment associée à ChDir, qui permet de modifier le répertoire courant, ainsi qu'à MkDir, qui crée un nouveau dossier. Ensemble, ces fonctions facilitent la gestion des répertoires dans une application Access. Elles sont particulièrement utiles pour organiser automatiquement les fichiers produits par le programme.
- Le chemin retourné dépend du système d'exploitation et du contexte d'exécution : Le résultat fourni par CurDir varie selon le lecteur actif, le compte utilisateur et le contexte dans lequel l'application est exécutée. Par exemple, une base Access ouverte depuis un partage réseau peut avoir un répertoire courant différent d'une base exécutée localement. Les développeurs doivent donc éviter de supposer que le chemin sera identique sur tous les postes de travail.
- La fonction est compatible avec toutes les versions modernes de Microsoft Access : La fonction CurDir est présente depuis les premières versions de Microsoft Access intégrant VBA et son comportement est demeuré stable au fil des années. Elle est compatible avec Access 2000, Access XP, Access 2003, Access 2007, Access 2010, Access 2013, Access 2016 ainsi qu'avec Microsoft 365. Cette stabilité garantit un fonctionnement cohérent des applications utilisant la gestion des fichiers et des répertoires.
Exemple
Voici un exemple de comment utiliser la fonction CurDir dans Microsoft Access :
CurDir ()
Résultat: "C:\Documents and Settings\user\My Documents"
CurDir ("G")
Résultat: "G:\"
Exemple de code VBA
La fonction CurDir peut être utilisée dans le code VBA de Microsoft Access.
Par exemple :
Dim LResult As String
LResult = CurDir ()
Dans cet exemple, la variable appelée LResult contiendrait désormais la valeur « C:\Documents and Settings\user\My Documents ».
Dernière mise à jour : Mardi, le 28 juillet 2015