FileSystemProxy.GetFiles Méthode

Définition

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

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

directory a la valeur Nothing.

Le dossier à rechercher n'existe pas.

directory pointe vers un fichier existant.

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

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

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

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

S’applique à

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

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

directory a la valeur Nothing.

Le dossier à rechercher n'existe pas.

directory pointe vers un fichier existant.

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

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

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

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

S’applique à