FileSystemProxy.GetFiles Méthode

Définition

Espace de noms:

Microsoft.VisualBasic.MyServices

Assembly:

Microsoft.VisualBasic.Forms.dll

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

Surcharges

GetFiles(String, SearchOption, String[])	Retourne une collection en lecture seule de chaînes qui représentent le nom des fichiers d'un répertoire.
GetFiles(String)	Retourne une collection en lecture seule de chaînes qui représentent le nom des fichiers d'un répertoire.

GetFiles(String, SearchOption, String[])

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

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);

public System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);

member this.GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Function GetFiles (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)

Paramètres

directory

String

Répertoire dans lequel effectuer la recherche.

searchType

SearchOption

Inclure, ou non, les sous-dossiers. La valeur par défaut est SearchOption.SearchTopLevelOnly.

wildcards

String[]

Modèle auquel correspondre.

Retours

ReadOnlyCollection<String>

Collection en lecture seule de noms de fichiers issus du répertoire spécifié.

Exceptions

ArgumentException

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 ne contient que des espaces blancs ; il contient des caractères non valides ; ou il s’agit d’un chemin d’appareil (commence par \\.\).

ArgumentNullException

directory a la valeur Nothing.

DirectoryNotFoundException

Le dossier à rechercher n'existe pas.

IOException

directory pointe vers un fichier existant.

PathTooLongException

Le chemin d'accès dépasse la longueur maximale définie par le système.

NotSupportedException

Un nom de fichier ou de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.

SecurityException

L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès.

UnauthorizedAccessException

L'utilisateur n'a pas les autorisations nécessaires.

Exemples

L’exemple suivant retourne tous les fichiers contenus dans le répertoire et les ajoute à ListBox1.

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

Cet exemple nécessite que vous ayez un ListBox nom ListBox1 dans votre formulaire.

Cet exemple retourne tous les fichiers du répertoire avec l’extension .txt et les ajoute à 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 nécessite que vous ayez un ListBox nom ListBox1 dans votre formulaire.

Remarques

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

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

À	Consultez
Obtenir la collection de fichiers dans un répertoire	Procédure : placer la collection de fichiers dans un répertoire
Rechercher des fichiers avec un modèle spécifique dans un répertoire	Procédure : rechercher des fichiers avec un modèle spécifique

Voir aussi

• SearchOption
• ReadOnlyCollection<T>
• Objets (Visual Basic)
• Guide pratique pour rechercher des fichiers avec un modèle spécifique en Visual Basic
• Guide pratique pour obtenir la collection de fichiers dans un répertoire en Visual Basic

GetFiles(String)

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

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);

public System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory);

member this.GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Function GetFiles (directory As String) As ReadOnlyCollection(Of String)

Paramètres

directory

String

Répertoire dans lequel effectuer la recherche.

Retours

ReadOnlyCollection<String>

Collection en lecture seule de noms de fichiers issus du répertoire spécifié.

Exceptions

ArgumentException

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 ne contient que des espaces blancs ; il contient des caractères non valides ; ou il s’agit d’un chemin d’appareil (commence par \\.\).

ArgumentNullException

directory a la valeur Nothing.

DirectoryNotFoundException

Le dossier à rechercher n'existe pas.

IOException

directory pointe vers un fichier existant.

PathTooLongException

Le chemin d'accès dépasse la longueur maximale définie par le système.

NotSupportedException

Un nom de fichier ou de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.

SecurityException

L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès.

UnauthorizedAccessException

L'utilisateur n'a pas les autorisations nécessaires.

Exemples

L’exemple suivant retourne tous les fichiers contenus dans le répertoire et les ajoute à ListBox1.

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

Cet exemple nécessite que vous ayez un ListBox nom ListBox1 dans votre formulaire.

Cet exemple retourne tous les fichiers du répertoire avec l’extension .txt et les ajoute à 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 nécessite que vous ayez un ListBox nom ListBox1 dans votre formulaire.

Remarques

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

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

À	Consultez
Obtenir la collection de fichiers dans un répertoire	Procédure : placer la collection de fichiers dans un répertoire
Rechercher des fichiers avec un modèle spécifique dans un répertoire	Procédure : rechercher des fichiers avec un modèle spécifique

Voir aussi

• ReadOnlyCollection<T>
• Objets (Visual Basic)
• Guide pratique pour rechercher des fichiers avec un modèle spécifique en Visual Basic
• Guide pratique pour obtenir la collection de fichiers dans un répertoire en Visual Basic