My.Computer.FileSystem.GetFiles, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Retourne une collection en lecture seule de chaînes qui représentent le nom des fichiers d'un répertoire.

' Usage
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetFiles(directory)
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetFiles(directory ,searchType ,wildcards)
' Declaration
Public Function GetFiles( _
   ByVal directory As String _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
' -or-
Public Function GetFiles( _
   ByVal directory As String, _
   ByVal searchType As SearchOption, _
   ByVal wildcards As String() _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)

Paramètres

directory
String. Répertoire à rechercher. Obligatoire.
searchType
SearchOption, énumération. Inclure, ou non, les sous-dossiers. La valeur par défaut est SearchOption.SearchTopLevelOnly. Obligatoire.
wildcards
String. Modèle à mettre en correspondance. Obligatoire.

Valeur de retour

Collection en lecture seule de chaînes.

Exceptions

Les conditions ci-dessous peuvent générer une exception :

Le chemin d'accès n'est pas valide pour une des raisons suivantes : il s'agit d'une chaîne de longueur nulle ; il ne contient que des espaces blancs ; il contient des caractères non valides ou il s'agit d'un chemin d'accès de périphérique (qui commence par \\.\) (ArgumentException).
Le chemin d'accès n'est pas valide, car il a la valeur Nothing (ArgumentNullException).
directory n'existe pas (DirectoryNotFoundException).
directory pointe vers un fichier existant (IOException).
Le chemin d'accès dépasse la longueur maximale définie par le système (PathTooLongException).
Un nom de fichier ou de répertoire du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct (NotSupportedException).
L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès (SecurityException).
L'utilisateur n'a pas les autorisations nécessaires (UnauthorizedAccessException).

Notes

Une collection vide est retournée si aucun fichier correspondant au modèle spécifié n'est trouvé.

Tâches

Le tableau suivant répertorie des exemples de tâches impliquant la méthode My.Computer.FileSystem.GetFiles.

Pour	Consultez
Obtenir la collection de fichiers d'un répertoire	Comment : placer la collection de fichiers dans un répertoire dans Visual Basic
Rechercher des fichiers d'un modèle spécifique dans un répertoire	Comment : rechercher des fichiers avec un modèle spécifique dans Visual Basic

Exemple

L'exemple suivant retourne tous les fichiers du répertoire et les ajoute dans ListBox1.

For Each foundFile As String In My.Computer.FileSystem.GetFiles _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    ListBox1.Items.Add(foundFile)
Next

Cet exemple implique que vous disposiez dans votre formulaire d'un ListBox nommé ListBox1.

Cet exemple retourne tous les fichiers du répertoire dont l'extension est .dll et les ajoute dans ListBox1.

For Each foundFile As String In My.Computer.FileSystem.GetFiles _
      (My.Computer.FileSystem.SpecialDirectories.MyDocuments, _
       FileIO.SearchOption.SearchTopLevelOnly, "*.txt")
    ListBox1.Items.Add(foundFile)
Next

Cet exemple implique que vous disposiez dans votre formulaire d'un ListBox nommé ListBox1.

Configuration requise

Espace de noms :Microsoft.VisualBasic.MyServices

Classe :FileSystemProxy (fournit l'accès à FileSystem)

Assembly : bibliothèque runtime Visual Basic (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Type de projet	Disponible
Application Windows	Oui
Bibliothèque de classes	Oui
Application console	Oui
Bibliothèque de contrôles Windows	Oui
Bibliothèque de contrôles Web	Oui
Service Windows	Oui
Site Web	Oui