Table of contents
TOC
Réduire la table des matières
Développer la table des matières

Dir, fonctionDir Function

office 365 dev account|Dernière mise à jour: 30/01/2018
|
2 Collaborateurs

Renvoie une valeur de type String qui représente le nom d'un fichier, d'un répertoire ou d'un dossier correspondant à une chaîne de recherche ou à un attribut de fichier, ou encore le nom de volume d'un lecteur.Returns a String representing the name of a file, directory, or folder that matches a specified pattern or file attribute, or the volume label of a drive.SyntaxDir [ (pathname [ ,attributes ] ) ] La syntaxe de la fonction Dir comporte les éléments suivants :SyntaxDir [ (pathname [ ,attributes ] ) ] The Dir function syntax has these parts:

ÉlémentPartDescriptionDescription
pathnamepathnameFacultatif.Optional.Expression de chaîne qui indique un nom de fichier ; peut inclure un répertoire ou un dossier, et un lecteur.Required. String expression that specifies a file name — may include directory or folder, and drive.Une chaîne de longueur nulle (« ») est renvoyée si pathname est introuvable.A zero-length string ("") is returned if pathname is not found.
attributesattributesFacultatif.Optional.Constante ou expression numérique, dont la somme spécifie des attributs de fichier.Required. Constant or numeric expression, whose sum specifies file attributes.Si cet argument est omis, il retourne des fichiers qui correspondent à pathname mais qui n’ont aucun attribut.Optional. Constant or numeric expression, whose sum specifies file attributes. If omitted, returns files that match pathname but have no attributes.

Paramètres Les paramètres de l’argument attributessont les suivants :Settings The attributesargument settings are:

ConstanteConstantValeurValueDescriptionDescription
vbNormalvbNormal00%(Valeur par défaut) Spécifie des fichiers sans attributs.(Default) Specifies files with no attributes.
vbReadOnlyvbReadOnly11Spécifie des fichiers en lecture seule et des fichiers sans attribut.Specifies read-only files in addition to files with no attributes.
vbHiddenvbHidden22Spécifie des fichiers masqués et des fichiers sans attribut.Specifies hidden files in addition to files with no attributes.
VbSystemVbSystem44Spécifie des fichiers système et des fichiers sans attribut. Non disponible sur Macintosh.Specifies system files in addition to files with no attributes. Not available on the Macintosh.
vbVolumevbVolume88*Spécifie un nom de volume. Si un autre attribut est spécifié, la constante vbVolume est ignorée. Non disponible sur Mac.Specifies volume label; if any other attributed is specified, vbVolume is ignored. Not available on the Macintosh.
vbDirectoryvbDirectory161.6Spécifie des répertoires ou des dossiers et des fichiers sans attributs.Specifies directories or folders in addition to files with no attributes.
vbAliasvbAlias646.4Le nom du fichier spécifié est un alias. Disponible uniquement sur Macintosh.Specified file name is an alias. Available only on the Macintosh.

Remarque Ces constantes sont spécifiées par Visual Basic pour Applications et peuvent remplacer les valeurs réelles dans tout votre code.Note These constants are specified by Visual Basic for Applications and can be used anywhere in your code in place of the actual values.

Remarques Sous Microsoft Windows, Dir prend en charge l’utilisation de caractères génériques à plusieurs caractères ( \* ) et à un seul caractère ( ?Remarks In Microsoft Windows, Dir supports the use of multiple character ( \* ) and single character ( ?) pour spécifier plusieurs fichiers.) wildcards to specify multiple files.Sous Macintosh, ces caractères sont traités comme des caractères de nom de fichier valides et ne peuvent pas être utilisés comme caractères génériques pour spécifier plusieurs fichiers.In Microsoft Windows, Dir supports the use of multiple character (*) and single character (?) wildcards to specify multiple files. On the Macintosh, these characters are treated as valid file name characters and can't be used as wildcards to specify multiple files.Étant donné que Macintosh ne prend pas en charge les caractères génériques, utilisez le type de fichier pour identifier des groupes de fichiers.Since the Macintosh doesn't support the wildcards, use the file type to identify groups of files.Vous pouvez utiliser la fonction MacID pour spécifier le type de fichier au lieu d’utiliser les noms de fichier.You can use the MacID function to specify file type instead of using the file names.Par exemple, l’instruction suivante retourne le nom du premier fichier texte dans le dossier actif :For example, the following statement returns the name of the first TEXT file in the current folder:

Dir("SomePath", MacID("TEXT"))

Pour itérer sur tous les fichiers d’un dossier, spécifiez une chaîne vide :To iterate over all files in a folder, specify an empty string:

Dir("")

Si vous utilisez la fonction MacID avec Dir sous Microsoft Windows, une erreur se produit.If you use the MacID function with Dir in Microsoft Windows, an error occurs.Toute valeur de l’argument attribute supérieure à 256 est considérée comme une valeur MacID.Any attribute value greater than 256 is considered a MacID value.Vous devez spécifier l’argument pathname la première fois que vous appelez la fonction Dir, sinon une erreur se produit.You must specify pathname the first time you call the Dir function, or an error occurs. If you also specify file attributes, pathname must be included.Si vous spécifiez également des attributs de fichier, pathname doit être inclus.If you also specify file attributes, pathname must be included.Dir retourne le premier nom de fichier correspondant à pathname.Dir returns the first file name that matches pathname.Pour obtenir des noms de fichiers supplémentaires correspondant à pathname, appelez Dir une nouvelle fois sans aucun argument.To get any additional file names that match pathname, call Dir again with no arguments.Lorsque plus aucun nom de fichier ne correspond, Dir retourne une chaîne nulle ("").When no more file names match, Dir returns a zero-length string ("").Une fois la chaîne nulle retournée, vous devez spécifier pathname dans les appels ultérieurs, sinon une erreur se produit.Once a zero-length string is returned, you must specify pathname in subsequent calls or an error occurs.Vous pouvez attribuer une nouvelle valeur à pathname sans récupérer tous les noms de fichier correspondant à la valeur actuelle de pathname.You can change to a new pathname without retrieving all of the file names that match the current pathname.Toutefois, vous ne pouvez pas appeler la fonction Dir de manière récursive.However, you can't call the Dir function recursively.L’appel de Dir avec l’attribut vbDirectory ne retourne pas continuellement de sous-répertoires.Calling Dir with the vbDirectory attribute does not continually return subdirectories.Avec Excel pour Mac 2016, l’appel de la fonction Dir initiale réussit.With Excel for Mac 2016, the initial Dir function call will succeed.Toutefois, les appels ultérieurs à itérer dans le répertoire spécifié entraînent une erreur.Subsequent calls to iterate through the specified directory will cause an error however.Il s’agit malheureusement d’un bogue connu.This is a known bug unfortunately.

Conseil Les noms de fichier sont récupérés sans ordre défini, mais vous pouvez les stocker dans un tableau et les trier.Tip Because file names are retrieved in no particular order, you may want to store returned file names in an array, and then sort the array.

© 2018 Microsoft