FileSystem.Dir Méthode

Définition

Espace de noms:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.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 au nom de volume d'un lecteur. Le FileSystem permet une meilleure productivité et de meilleures performances dans les opérations d'E/S de fichier que la fonction Dir. Consultez la rubrique GetDirectoryInfo(String) (éventuellement en anglais) pour plus d'informations.

Surcharges

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 au nom de volume d'un lecteur. Le FileSystem permet une meilleure productivité et de meilleures performances dans les opérations d'E/S de fichier que la fonction Dir. Consultez la rubrique GetDirectoryInfo(String) (éventuellement en anglais) pour plus d'informations.

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 au nom de volume d'un lecteur. Le FileSystem permet une meilleure productivité et de meilleures performances dans les opérations d'E/S de fichier que la fonction Dir. Consultez la rubrique GetDirectoryInfo(String) (éventuellement en anglais) pour plus d'informations.

Dir()

Source:

FileSystem.vb

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. Le FileSystem permet une meilleure productivité et de meilleures performances dans les opérations d'E/S de fichier que la fonction Dir. Consultez la rubrique GetDirectoryInfo(String) (éventuellement en anglais) pour plus d'informations.

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 attribut de fichier ou de modèle spécifié ou au nom 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 à plusieurs caractères (*) et à caractère unique (?) pour spécifier plusieurs fichiers.

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

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

Important

Pour s’exécuter correctement, la Dir fonction nécessite que les Read indicateurs et PathDiscovery de FileIOPermission soient accordés au code en cours d’exécution. Pour plus d’informations, consultez FileIOPermissionAutorisations d’accès au code , SecurityExceptionet .

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

Valeur	Constant	Description
Normal	vbnormal	Par défaut. 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 é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 au lieu des valeurs réelles.

Voir aussi

• ChDir(String)
• ChDrive
• FileAttribute

Dir(String, FileAttribute)

Source:

FileSystem.vb

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. Le FileSystem permet une meilleure productivité et de meilleures performances dans les opérations d'E/S de fichier que la fonction Dir. Consultez la rubrique GetDirectoryInfo(String) (éventuellement en anglais) pour plus d'informations.

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string Dir (string PathName, Microsoft.VisualBasic.FileAttribute Attributes = Microsoft.VisualBasic.FileAttribute.Normal);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Dir : string * Microsoft.VisualBasic.FileAttribute -> string

Public Function Dir (PathName As String, Optional Attributes As FileAttribute = Microsoft.VisualBasic.FileAttribute.Normal) As String

Paramètres

PathName

String

Optionnel. Une expression de chaîne qui spécifie un nom de fichier, de répertoire ou de dossier, ou l’étiquette du volume d’un lecteur. Une chaîne de longueur nulle ("") est retournée si PathName n'est pas trouvé.

Attributes

FileAttribute

Optionnel. Énumération ou expression numérique dont la valeur spécifie des attributs de fichier. En cas d'omission, Dir retourne des fichiers qui correspondent à Pathname, mais n'ont pas d'attributs.

Retours

String

Chaîne représentant le nom d'un fichier, d'un répertoire ou d'un dossier qui correspond à un attribut de fichier ou de modèle spécifié ou au nom de volume d'un lecteur.

Attributs

SupportedOSPlatformAttribute

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 à plusieurs caractères (*) et à caractère unique (?) pour spécifier plusieurs fichiers.
VbVolume retourne l’étiquette du volume pour le lecteur au lieu d’un nom de fichier spécifique.
Vous devez fournir un PathName la 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 aucun paramètre.

Important

Pour s’exécuter correctement, la Dir fonction nécessite que les Read indicateurs et PathDiscovery de FileIOPermission soient accordés au code en cours d’exécution. Pour plus d’informations, consultez FileIOPermissionAutorisations d’accès au code , SecurityExceptionet .
Les Attributes valeurs d’énumération de l’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 pas d’attributs.|
| Hidden | vbHidden|Spécifie les fichiers masqués, en plus des fichiers qui n’ont pas d’attributs.|
| 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é.|
| Directory | vbDirectory|Spécifie des répertoires ou des dossiers, en plus des fichiers qui n’ont pas d’attributs.|
| Archive | vbArchive|Le fichier a changé depuis la dernière sauvegarde.|
| Alias | vbAlias|Le nom du fichier est 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.

Voir aussi

• ChDir(String)
• ChDrive
• FileAttribute