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

  • Article

Les surcharges de la méthode FileSystem.GetFiles retournent une collection en lecture seule de chaînes représentant les noms des fichiers contenus 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 paramètre wildCards pour spécifier un modèle de recherche. Pour inclure des sous-répertoires dans la recherche, affectez la valeur searchType au paramètre SearchOption.SearchAllSubDirectories.

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

Pour énumérer les fichiers contenus dans un répertoire

  • Utilisez l'une des surcharges de méthode FileSystem.GetFiles, en fournissant le nom et le chemin d'accès au répertoire dans lequel effectuer la recherche dans le paramètre directory. L’exemple suivant retourne tous les fichiers contenus dans le 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 fiable

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

  • Le chemin n’est pas valide pour l’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’appareil (qui commence par \\.\) (ArgumentException).

  • Le chemin 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 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 (SecurityException).

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

Voir aussi