FileSystem.Dir, méthode ()

Retourne une chaîne représentant le nom d'un fichier, d'un répertoire ou d'un dossier qui correspond à un modèle ou un attribut de fichier spécifié ou au nom de volume d'un lecteur. L'objet My.Computer.FileSystem permet une meilleure productivité et de meilleures performances que la fonction Dir dans les opérations d'E/S de fichier. Consultez My.Computer.FileSystem.GetDirectoryInfo, méthode pour plus d'informations.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Function Dir As String
'Utilisation
Dim returnValue As String

returnValue = FileSystem.Dir

public static string Dir ()

public:
static String^ Dir ()

public static String Dir ()

public static function Dir () : String

Valeur de retour

Retourne une chaîne représentant le nom d'un fichier, d'un répertoire ou d'un dossier qui correspond à un modèle ou un attribut de fichier spécifié ou au nom de volume d'un lecteur. L'objet My.Computer.FileSystem permet une meilleure productivité et de meilleures performances que la fonction Dir dans les opérations d'E/S de fichier. Pour plus d'informations, consultez My.Computer.FileSystem.GetDirectoryInfo, méthode.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic Dir, fonction.

La fonction Dir prend en charge l'utilisation de caractères génériques multiples (* ou uniques (?) pour spécifier plusieurs fichiers.

VbVolume retourne le nom de volume du lecteur au lieu d'un nom de fichier spécifique.

Vous devez fournir un PathName la première fois que vous appelez la fonction Dir. Pour récupérer l'élément suivant, vous pouvez faire d'autres appels à la fonction Dir sans paramètres.

Remarque de sécurité
Pour s'exécuter correctement, la fonction Dir requiert l'attribution au code en cours d'exécution des indicateurs Read et PathDiscovery de FileIOPermission. Pour plus d'informations, consultez FileIOPermission, SecurityException et Autorisations d'accès du code.

Les valeurs d'énumération de l'argument Attributes sont les suivantes :

Valeur	Constante	Description
Normal	vbnormal	Valeur par défaut. Spécifie des fichiers sans attributs.
ReadOnly	vbReadOnly	Spécifie des fichiers en lecture seule, en plus de fichiers sans attributs.
Hidden	vbHidden	Spécifie des fichiers masqués, en plus de fichiers sans attributs.
System	vbSystem	Spécifie des fichiers systèmes, en plus de fichiers sans attributs.
Volume	vbVolume	Spécifie le nom de volume ; si un autre attribut est spécifié, vbVolume est ignoré.
Directory	vbDirectory	Spécifie des répertoires ou des dossiers, en plus de fichiers sans attributs.
Archive	vbArchive	Le fichier a été modifié depuis sa dernière sauvegarde.
Alias	vbAlias	Le fichier porte un nom différent.

Notes

Ces énumérations sont spécifiées par le langage Visual Basic et peuvent être utilisées n'importe où dans votre code à la place des valeurs réelles.

Exemple

Cet exemple utilise la fonction Dir pour vérifier si certains fichiers et répertoires existent.

Dim MyFile, MyPath, MyName As String
' Returns "WIN.INI" if it exists.
MyFile = Dir("C:\WINDOWS\WIN.INI")   

' Returns filename with specified extension. If more than one *.INI
' file exists, the first file found is returned.
MyFile = Dir("C:\WINDOWS\*.INI")

' Call Dir again without arguments to return the next *.INI file in the
' same directory.
MyFile = Dir()

' Return first *.TXT file, including files with a set hidden attribute.
MyFile = Dir("*.TXT", vbHidden)

' Display the names in C:\ that represent directories.
MyPath = "c:\"   ' Set the path.
MyName = Dir(MyPath, vbDirectory)   ' Retrieve the first entry.
Do While MyName <> ""   ' Start the loop.
      ' Use bitwise comparison to make sure MyName is a directory.
      If (GetAttr(MyPath & MyName) And vbDirectory) = vbDirectory Then
         ' Display entry only if it's a directory.
         MsgBox(MyName)
      End If   
   MyName = Dir()   ' Get next entry.
Loop

Plates-formes

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Voir aussi

Référence

FileSystem, classe
Membres FileSystem
Microsoft.VisualBasic, espace de noms

Autres ressources

Dir, fonction
ChDir, fonction
CurDir, fonction
FileAttribute, énumération