GETATTR |
Demande l'attribut |
|---|---|
| Access 2019, Access 2016, Access 2013, Access 2010, Access 2007, Access 2003, Access XP, Access 2000 | Microsoft Access |
Syntaxe
| GetAttr(path) |
Paramètres
| Nom | Description |
|---|---|
| path | Ce paramètre permet d'indiquer le chemin d'un fichier, d'un dossier ou d'un répertoire à laquelle il faut demander les attributs. |
Retour
Voici les valeurs pouvant être combiné et retourner par la fonction :
| Valeur | Constante | Description |
|---|---|---|
| 0 | vbNormal | Cette valeur permet d'indiquer un attribut normal. |
| 1 | vbReadOnly | Cette valeur permet d'indiquer un attribut de lecture seulement. |
| 2 | vbHidden | Cette valeur permet d'indiquer un attribut de caché. |
| 4 | vbSystem | Cette valeur permet d'indiquer un attribut de fichier système. |
| 16 | vbDirectory | Cette valeur permet d'indiquer un attribut de dossier ou répertoire. |
| 32 | vbArchive | Cette valeur permet d'indiquer un attribut d'archive, soit un fichier ayant été modifié depuis la dernière sauvegarde. |
| 64 | vbAlias | Cette valeur permet d'indiquer un attribut d'alias. |
Description
Cette fonction permet de demander les attributs d'un fichier ou d'un répertoire.
Remarques
- Les constantes du VisualBasic (vb*) peuvent seulement être référencé dans un code VBA et ne sont donc pas accessible dans une requête Access.
- La fonction retourne les attributs d'un fichier ou d'un dossier : La fonction GetAttr permet de connaître les attributs associés à un fichier ou à un répertoire du système de fichiers. Elle retourne une valeur numérique représentant un ou plusieurs attributs combinés. Cette information est utile pour adapter le comportement d'une application selon les caractéristiques du fichier.
- Le paramètre doit désigner un chemin valide : Le paramètre path doit contenir le chemin d'un fichier ou d'un dossier existant. Ce chemin peut être absolu ou relatif selon le répertoire courant de l'application. Si le chemin est incorrect ou si l'élément n'existe pas, GetAttr génère une erreur d'exécution.
- Plusieurs attributs peuvent être présents simultanément : La valeur retournée par GetAttr est une combinaison de plusieurs constantes, telles que vbReadOnly, vbHidden, vbSystem ou vbArchive. Par exemple, un fichier peut être à la fois caché et en lecture seule. Il est donc nécessaire d'utiliser des opérations binaires (And) pour vérifier la présence d'un attribut particulier.
- Elle permet de détecter les fichiers en lecture seulement : L'un des usages les plus fréquents de GetAttr consiste à vérifier si un fichier possède l'attribut vbReadOnly. Cette vérification permet d'éviter des erreurs lors d'une tentative de modification ou de suppression. Elle est particulièrement utile dans les applications manipulant des documents partagés.
- La fonction peut identifier les dossiers : Grâce à l'attribut vbDirectory, GetAttr permet de distinguer un dossier d'un fichier classique. Cette information est précieuse lors du parcours d'une arborescence de répertoires. Elle permet notamment d'éviter de traiter un dossier comme s'il s'agissait d'un fichier.
- Les constantes vb... sont disponibles uniquement en VBA : Les constantes telles que vbHidden, vbSystem ou vbArchive peuvent être utilisées directement dans le code VBA. En revanche, elles ne sont pas reconnues dans les requêtes Access et doivent alors être remplacées par leurs valeurs numériques correspondantes. Cette différence est importante lors du développement d'applications mixtes utilisant à la fois VBA et SQL Access.
- Elle est souvent utilisée avec d'autres fonctions de gestion des fichiers : GetAttr est fréquemment combinée avec Dir, FileLen, FileDateTime ou SetAttr. Ensemble, ces fonctions permettent de vérifier l'existence d'un fichier, connaître sa taille, sa date de modification, ses attributs ou encore modifier certaines de ses propriétés. Elles constituent les principales fonctions de manipulation des fichiers en VBA.
- Une gestion des erreurs est recommandée : Comme GetAttr génère une erreur lorsqu'un fichier est introuvable ou inaccessible, il est conseillé de vérifier son existence avec Dir ou d'utiliser une gestion d'erreurs (On Error). Cette précaution améliore la robustesse des applications Access. Elle évite également les interruptions inattendues lors du traitement de fichiers externes.
- Elle est utile pour les applications de sauvegarde et d'administration : Les programmes de maintenance utilisent souvent GetAttr pour déterminer si un fichier possède l'attribut d'archive (vbArchive) ou s'il est caché. Ces informations permettent de sélectionner les fichiers à sauvegarder ou à ignorer. La fonction est donc particulièrement intéressante pour les utilitaires de gestion documentaire et les outils d'administration.
- La fonction est compatible avec toutes les versions modernes de Microsoft Access : La fonction GetAttr est disponible depuis les premières versions de Microsoft Access intégrant VBA et son fonctionnement 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 que les applications utilisant les attributs des fichiers continueront de fonctionner correctement lors des migrations vers des versions plus récentes d'Access.
Exemple
Voici un exemple de comment utiliser la fonction GetAttr dans Microsoft Access :
GetAttr ("C:\instructions.doc")
Résultat: 0
GetAttr ("H:\Documents\Supplies.xls")
Résultat: 1
Exemple de code VBA
La fonction GetAttr peut être utilisée dans le code VBA de Microsoft Access.
Par exemple :
Dim LResult As Integer
LResult = GetAttr ("C:\instructions.doc")
Dans cet exemple, la variable appelée LResult contiendrait désormais la représentation entière des attributs du fichier instructions.doc.
Dernière mise à jour : Mardi, le 28 juillet 2015