FileSystemProxy.GetFiles Méthode

Définition

Renvoie une collection en lecture seule de chaînes représentant les noms de fichiers dans un répertoire.

Surcharges

Nom Description
GetFiles(String, SearchOption, String[])

Renvoie une collection en lecture seule de chaînes représentant les noms de fichiers dans un répertoire.

GetFiles(String)

Renvoie une collection en lecture seule de chaînes représentant les noms de fichiers dans un répertoire.

GetFiles(String, SearchOption, String[])

Renvoie une collection en lecture seule de chaînes représentant les noms de fichiers dans 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 à rechercher.

searchType
SearchOption

Indique s’il faut inclure des sous-dossiers. La valeur par défaut est SearchOption.SearchTopLevelOnly.

wildcards
String[]

Modèle à mettre en correspondance.

Retours

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

Exceptions

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 de l’espace blanc ; contient des caractères non valides ; ou il s’agit d’un chemin d’accès d’appareil (commence par \\.\).

directory a la valeur Nothing.

Le répertoire à rechercher n’existe pas.

directory pointe vers un fichier existant.

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

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

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

L’utilisateur ne dispose pas des autorisations nécessaires.

Exemples

L’exemple suivant retourne tous les fichiers du 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 sur 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 sur votre formulaire.

Remarques

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

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 : obtenir la collection de fichiers dans un répertoire
Rechercher des fichiers avec un modèle spécifique dans un répertoire Guide pratique pour rechercher des fichiers avec un modèle spécifique

Voir aussi

S’applique à

GetFiles(String)

Renvoie une collection en lecture seule de chaînes représentant les noms de fichiers dans 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 à rechercher.

Retours

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

Exceptions

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 de l’espace blanc ; contient des caractères non valides ; ou il s’agit d’un chemin d’accès d’appareil (commence par \\.\).

directory a la valeur Nothing.

Le répertoire à rechercher n’existe pas.

directory pointe vers un fichier existant.

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

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

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

L’utilisateur ne dispose pas des autorisations nécessaires.

Exemples

L’exemple suivant retourne tous les fichiers du 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 sur 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 sur votre formulaire.

Remarques

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

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 : obtenir la collection de fichiers dans un répertoire
Rechercher des fichiers avec un modèle spécifique dans un répertoire Guide pratique pour rechercher des fichiers avec un modèle spécifique

Voir aussi

S’applique à