Partager via


Guide pratique pour obtenir la collection de fichiers dans un répertoire en Visual Basic

Les surcharges de la FileSystem.GetFiles méthode retournent une collection en lecture seule de chaînes représentant les noms des fichiers dans un répertoire :

  • Utilisez la surcharge GetFiles(String) pour effectuer une recherche de fichier simple dans un répertoire spécifié, sans rechercher dans les sous-répertoires.

  • Utilisez la surcharge GetFiles(String, SearchOption, String[]) pour spécifier des options supplémentaires pour votre recherche. Vous pouvez utiliser le wildCards paramètre pour spécifier un modèle de recherche. Pour inclure des sous-répertoires dans la recherche, définissez le paramètre searchTypeSearchOption.SearchAllSubDirectories.

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

Pour répertorier les fichiers dans un répertoire

  • Utilisez l'une des FileSystem.GetFiles surcharges de méthode, en fournissant le nom et le chemin d'accès du répertoire à rechercher dans le paramètre directory. L’exemple suivant retourne tous les fichiers du répertoire et les ajoute à ListBox1.

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

Programmation robuste

Les conditions suivantes peuvent entraîner une exception :

  • Le chemin d’accès n’est pas valide pour l’une des raisons suivantes : il s’agit d’une chaîne de longueur nulle, il contient uniquement des espaces blancs, il contient des caractères non valides ou il s’agit d’un chemin d’accès d’appareil (commence par \\.\) (ArgumentException).

  • Le chemin d’accès n’est pas valide, car il est Nothing (ArgumentNullException).

  • directory n’existe pas (DirectoryNotFoundException).

  • directory pointe vers un fichier existant (IOException).

  • Le chemin dépasse la longueur maximale définie par le système (PathTooLongException).

  • Un nom de fichier ou de répertoire dans le chemin contient un signe deux-points (:) ou est dans un format non valide (NotSupportedException).

  • L’utilisateur ne dispose pas des autorisations nécessaires pour afficher le chemin d’accès (SecurityException).

  • L’utilisateur ne dispose pas des autorisations nécessaires (UnauthorizedAccessException).

Voir aussi