FileSystem.Dir Méthode

Définition

Espace de noms:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

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 à l’étiquette de volume d’un lecteur. Cela FileSystem vous donne une meilleure productivité et des performances dans les opérations d’E/S de fichier que la Dir fonction. Pour plus d’informations, consultez GetDirectoryInfo(String).

Surcharges

Nom Description
Dir()

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 à l’étiquette de volume d’un lecteur. Cela FileSystem vous donne une meilleure productivité et des performances dans les opérations d’E/S de fichier que la Dir fonction. Pour plus d’informations, consultez GetDirectoryInfo(String).
Dir(String, FileAttribute)

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 à l’étiquette de volume d’un lecteur. Cela FileSystem vous donne une meilleure productivité et des performances dans les opérations d’E/S de fichier que la Dir fonction. Pour plus d’informations, consultez GetDirectoryInfo(String).

Dir()

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 à l’étiquette de volume d’un lecteur. Cela FileSystem vous donne une meilleure productivité et des performances dans les opérations d’E/S de fichier que la Dir fonction. Pour plus d’informations, consultez GetDirectoryInfo(String).

public:
 static System::String ^ Dir();
public static string Dir();
static member Dir : unit -> string
Public Function Dir () As String

Retours

String

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 à l’étiquette de volume d’un lecteur.

Exemples

Cet exemple utilise la Dir fonction 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

Remarques

La Dir fonction prend en charge l’utilisation de caractères génériques à caractères multiples (*) et à caractère unique (?) pour spécifier plusieurs fichiers.

VbVolume retourne l’étiquette de volume du lecteur au lieu d’un nom de fichier spécifique.

Vous devez fournir la PathName première fois que vous appelez la Dir fonction. Pour récupérer l’élément suivant, vous pouvez effectuer des appels ultérieurs à la Dir fonction sans paramètres.

Important

Pour s’exécuter correctement, la Dir fonction nécessite l’octroi ReadPathDiscovery des indicateurs et des indicateurs du FileIOPermission code en cours d’exécution. Pour plus d’informations, consultez FileIOPermission, SecurityExceptionet autorisations d’accès au code.

Les Attributes valeurs d’énumération d’argument sont les suivantes :

Valeur Constante Description
Normal vbnormal Default. Spécifie les fichiers sans attributs.
ReadOnly vbReadOnly Spécifie les fichiers en lecture seule, ainsi que les fichiers sans attributs.
Hidden vbHidden Spécifie les fichiers masqués, ainsi que les fichiers sans attributs.
System vbSystem Spécifie les fichiers système, ainsi que les fichiers sans attributs.
Volume vbVolume Spécifie l’étiquette du volume ; si un autre attribut est spécifié, vbVolume est ignoré.
Directory vbDirectory Spécifie des répertoires ou des dossiers, ainsi que des fichiers sans attributs.
Archive vbArchive Le fichier a changé depuis la dernière sauvegarde.
Alias vbAlias Le fichier a un nom différent.

Note

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

Voir aussi

S’applique à

Dir(String, FileAttribute)

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 à l’étiquette de volume d’un lecteur. Cela FileSystem vous donne une meilleure productivité et des performances dans les opérations d’E/S de fichier que la Dir fonction. Pour plus d’informations, consultez GetDirectoryInfo(String).

public static string Dir(string Pathname, Microsoft.VisualBasic.FileAttribute Attributes = Microsoft.VisualBasic.FileAttribute.Normal);
public static string Dir(string PathName, Microsoft.VisualBasic.FileAttribute Attributes = Microsoft.VisualBasic.FileAttribute.Normal);
static member Dir : string * Microsoft.VisualBasic.FileAttribute -> string
static member Dir : string * Microsoft.VisualBasic.FileAttribute -> string
Public Function Dir (Pathname As String, Optional Attributes As FileAttribute = Microsoft.VisualBasic.FileAttribute.Normal) As String
Public Function Dir (PathName As String, Optional Attributes As FileAttribute = Microsoft.VisualBasic.FileAttribute.Normal) As String

Paramètres

PathnamePathName
String

Optional. Expression de chaîne qui spécifie un nom de fichier, un répertoire ou un nom de dossier ou une étiquette de volume de lecteur. Une chaîne de longueur nulle ("") est retournée si Pathname elle est introuvable.

Attributes
FileAttribute

Optional. Énumération ou expression numérique dont la valeur spécifie les attributs de fichier. S’il est omis, Dir retourne des fichiers qui correspondent Pathname mais n’ont aucun attribut.

Retours

String

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 à l’étiquette de volume d’un lecteur.

Exemples

Cet exemple utilise la Dir fonction 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

Remarques

La Dir fonction prend en charge l’utilisation de caractères génériques à caractères multiples (*) et à caractère unique (?) pour spécifier plusieurs fichiers. VbVolume retourne l’étiquette de volume du lecteur au lieu d’un nom de fichier spécifique. Vous devez fournir la PathName première fois que vous appelez la Dir fonction. Pour récupérer l’élément suivant, vous pouvez effectuer des appels ultérieurs à la Dir fonction sans paramètres.

Important

Pour s’exécuter correctement, la Dir fonction nécessite l’octroi ReadPathDiscovery des indicateurs et des indicateurs du FileIOPermission code en cours d’exécution. Pour plus d’informations, consultez FileIOPermission, SecurityExceptionet autorisations d’accès au code. Les Attributes valeurs d’énumération d’argument sont les suivantes : |Valeur|Constante|Description| |-|-|-| || |Normal|vbnormal|Par défaut. Spécifie les fichiers qui n’ont aucun attribut.| |ReadOnly|vbReadOnly|Spécifie les fichiers en lecture seule, en plus des fichiers qui n’ont aucun attribut.| |Hidden|vbHidden|Spécifie les fichiers masqués, en plus des fichiers qui n’ont aucun attribut.| |System|vbSystem|Spécifie les fichiers système, en plus des fichiers qui n’ont aucun attribut.| |Volume|vbVolume|Spécifie l’étiquette du volume ; si un autre attribut est spécifié, vbVolume est ignoré.| ||DirectoryvbDirectory|Spécifie des répertoires ou des dossiers, en plus des fichiers qui n’ont aucun attribut.| |Archive|vbArchive|Le fichier a changé depuis la dernière sauvegarde.| |Alias|vbAlias|Le fichier a un autre nom.|

Note

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

Voir aussi

S’applique à