FILELEN

Syntaxe

Paramètres

Description

Cette fonction permet de retourner la longueur en octets d'un fichier.

Remarques

• La fonction retourne la taille d'un fichier en octets : La fonction FileLen permet de connaître la longueur exacte d'un fichier enregistré sur un support d'entreposage. La valeur retournée correspond au nombre d'octets occupés par le contenu du fichier. Cette information est particulièrement utile pour contrôler des fichiers avant leur traitement ou leur transfert.
• Le paramètre doit désigner un fichier existant : Le paramètre file_path doit contenir un chemin valide pointant vers un fichier accessible. Il peut s'agir d'un chemin absolu ou relatif, selon le contexte d'exécution de l'application. Si le fichier n'existe pas ou si son chemin est incorrect, Microsoft Access génère une erreur d'exécution.
• La taille retournée correspond au contenu réel du fichier : La valeur renvoyée par FileLen représente la taille logique du fichier en octets et non l'espace réellement occupé sur le disque. En effet, les systèmes de fichiers allouent généralement les données par blocs ou unités d'allocations, ce qui peut entraîner une occupation disque supérieure à la taille indiquée. Cette distinction est importante lors de l'analyse de l'utilisation de l'espace disque.
• La fonction retourne une valeur numérique entière : Le résultat de FileLen est un nombre entier pouvant être utilisé directement dans des calculs ou des comparaisons. Il est ainsi possible de vérifier si un fichier dépasse une taille maximale ou s'il est vide. Cette valeur peut également être affichée dans un formulaire ou enregistrée dans une table.
• Elle est utile pour valider des fichiers avant leur traitement : Avant d'importer un document ou un fichier de données, il est souvent judicieux de vérifier sa taille. FileLen permet par exemple de détecter un fichier vide ou un fichier anormalement petit pouvant indiquer une erreur de génération. Cette vérification améliore la fiabilité des traitements automatisés.
• Elle peut être combinée avec d'autres fonctions de gestion des fichiers : FileLen est fréquemment utilisée avec Dir ou FileDateTime. Ensemble, ces fonctions permettent de vérifier l'existence d'un fichier, sa date de modification, sa taille et d'effectuer diverses opérations sur celui-ci. Elles constituent les principales fonctions de gestion des fichiers disponibles en VBA.

• Une erreur est générée si le fichier est inaccessible : Si le fichier est introuvable, si le chemin est invalide ou si l'utilisateur ne possède pas les droits d'accès nécessaires, FileLen provoque une erreur d'exécution. Pour éviter ce problème, il est recommandé de vérifier l'existence du fichier avec Dir ou d'utiliser une gestion d'erreurs (On Error). Cette pratique améliore la robustesse de l'application.
• Elle est très utilisée dans les procédures d'importation et d'exportation : Les applications Access utilisent souvent FileLen pour contrôler les fichiers avant leur lecture ou leur copie. Il est ainsi possible de détecter des fichiers incomplets, des sauvegardes anormalement petites ou des documents dépassant une limite de taille autorisée. Cette fonction contribue donc à la validation des données échangées.
• Elle ne permet pas d'obtenir d'autres informations sur le fichier : FileLen retourne uniquement la taille du fichier et ne fournit aucune indication sur sa date de création, sa date de modification, son propriétaire ou ses attributs. Pour obtenir ces informations, il faut utiliser d'autres fonctions telles que FileDateTime ou les objets du FileSystemObject. Chaque fonction est spécialisée dans un aspect particulier des propriétés des fichiers.
• La fonction est compatible avec toutes les versions modernes de Microsoft Access : La fonction FileLen 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 la compatibilité des applications manipulant des fichiers lors des migrations vers des versions plus récentes d'Access.

Exemple

Voici un exemple de comment utiliser la fonction FileLen dans Microsoft Access :