FileSystem.GetFiles FileSystem.GetFiles FileSystem.GetFiles FileSystem.GetFiles Method

Définition

Retourne une collection en lecture seule de chaînes qui représentent le nom des fichiers d'un répertoire.Returns a read-only collection of strings representing the names of files within a directory.

Surcharges

GetFiles(String) GetFiles(String) GetFiles(String) GetFiles(String)

Retourne une collection en lecture seule de chaînes qui représentent le nom des fichiers d'un répertoire.Returns a read-only collection of strings representing the names of files within a directory.

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

Retourne une collection en lecture seule de chaînes qui représentent le nom des fichiers d'un répertoire.Returns a read-only collection of strings representing the names of files within a directory.

GetFiles(String) GetFiles(String) GetFiles(String) GetFiles(String)

Retourne une collection en lecture seule de chaînes qui représentent le nom des fichiers d'un répertoire.Returns a read-only collection of strings representing the names of files within a directory.

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);
public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory);
static member GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Shared Function GetFiles (directory As String) As ReadOnlyCollection(Of String)

Paramètres

directory
String String String String

Répertoire dans lequel effectuer la recherche.Directory to be searched.

Retours

Collection en lecture seule de noms de fichiers issus du répertoire spécifié.Read-only collection of file names from the specified directory.

Exceptions

Le chemin n’est pas valide pour l’une des raisons suivantes : il s’agit d’une chaîne de longueur null ; il ne contient que des espaces blancs ; il contient des caractères non valides ; il s’agit d’un chemin d’accès d’appareil (commençant par \\.\).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\.\).

Le dossier à rechercher n'existe pas.The directory to search does not exist.

directory pointe vers un fichier existant.directory points to an existing file.

Le chemin d'accès dépasse la longueur maximale définie par le système.The path exceeds the system-defined maximum length.

Un nom de fichier ou de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.A file or directory name in the path contains a colon (:) or is in an invalid format.

L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès.The user lacks necessary permissions to view the path.

L'utilisateur n'a pas les autorisations nécessaires.The user lacks necessary permissions.

Exemples

L’exemple suivant retourne tous les fichiers contenus dans le répertoire et les ajoute à ListBox1.The following example returns all files in the directory and adds them to 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 nommé ListBox1 sur votre formulaire.This example requires that you have a ListBox named ListBox1 on your form.

Cet exemple retourne tous les fichiers du répertoire avec l’extension .txt et les ajoute à ListBox1.This example returns all files in the directory with the extension .txt and adds them to 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 nommé ListBox1 sur votre formulaire.This example requires that you have a ListBox named ListBox1 on your form.

Remarques

Une collection vide est retournée si aucun fichier correspondant au modèle spécifié n'est détecté.An empty collection is returned if no files matching the specified pattern are found.

Le tableau suivant répertorie des exemples de tâches My.Computer.FileSystem.GetFiles impliquant la méthode.The following table lists examples of tasks involving the My.Computer.FileSystem.GetFiles method.

ÀTo VoirSee
Obtenir la collection de fichiers dans un répertoireGet the collection of files in a directory Guide pratique : Obtenir la collection de fichiers dans un répertoire dans Visual BasicHow to: Get the Collection of Files in a Directory in Visual Basic
Rechercher des fichiers avec un modèle spécifique dans un répertoireFind files with a specific pattern in a directory Guide pratique pour Rechercher des fichiers avec un modèle spécifique dans Visual BasicHow to: Find Files with a Specific Pattern in Visual Basic

Sécurité

FileIOPermission
Contrôle la possibilité d’accéder aux fichiers et dossiers.Controls the ability to access files and folders. Énumération associée : Unrestricted.Associated enumeration: Unrestricted.

Voir aussi

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

Retourne une collection en lecture seule de chaînes qui représentent le nom des fichiers d'un répertoire.Returns a read-only collection of strings representing the names of files within a directory.

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);
public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);
static member GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Shared Function GetFiles (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)

Paramètres

directory
String String String String

Répertoire dans lequel effectuer la recherche.Directory to be searched.

searchType
SearchOption SearchOption SearchOption SearchOption

Inclure, ou non, les sous-dossiers.Whether to include subfolders. La valeur par défaut est SearchOption.SearchTopLevelOnly.Default is SearchOption.SearchTopLevelOnly.

wildcards
String[]

Modèle auquel correspondre.Pattern to be matched.

Retours

Collection en lecture seule de noms de fichiers issus du répertoire spécifié.Read-only collection of file names from the specified directory.

Exceptions

Le chemin n’est pas valide pour l’une des raisons suivantes : il s’agit d’une chaîne de longueur null ; il ne contient que des espaces blancs ; il contient des caractères non valides ; il s’agit d’un chemin d’accès d’appareil (commençant par \\.\).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\.\).

directory a la valeur Nothing.directory is Nothing.

Le dossier à rechercher n'existe pas.The directory to search does not exist.

directory pointe vers un fichier existant.directory points to an existing file.

Le chemin d'accès dépasse la longueur maximale définie par le système.The path exceeds the system-defined maximum length.

Un nom de fichier ou de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.A file or directory name in the path contains a colon (:) or is in an invalid format.

L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès.The user lacks necessary permissions to view the path.

L'utilisateur n'a pas les autorisations nécessaires.The user lacks necessary permissions.

Exemples

L’exemple suivant retourne tous les fichiers contenus dans le répertoire et les ajoute à ListBox1.The following example returns all files in the directory and adds them to 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 nommé ListBox1 sur votre formulaire.This example requires that you have a ListBox named ListBox1 on your form.

Cet exemple retourne tous les fichiers du répertoire avec l’extension .txt et les ajoute à ListBox1.This example returns all files in the directory with the extension .txt and adds them to 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 nommé ListBox1 sur votre formulaire.This example requires that you have a ListBox named ListBox1 on your form.

Remarques

Une collection vide est retournée si aucun fichier correspondant au modèle spécifié n'est détecté.An empty collection is returned if no files matching the specified pattern are found.

Le tableau suivant répertorie des exemples de tâches My.Computer.FileSystem.GetFiles impliquant la méthode.The following table lists examples of tasks involving the My.Computer.FileSystem.GetFiles method.

ÀTo VoirSee
Obtenir la collection de fichiers dans un répertoireGet the collection of files in a directory Guide pratique : Obtenir la collection de fichiers dans un répertoire dans Visual BasicHow to: Get the Collection of Files in a Directory in Visual Basic
Rechercher des fichiers avec un modèle spécifique dans un répertoireFind files with a specific pattern in a directory Guide pratique pour Rechercher des fichiers avec un modèle spécifique dans Visual BasicHow to: Find Files with a Specific Pattern in Visual Basic

Sécurité

FileIOPermission
Contrôle la possibilité d’accéder aux fichiers et dossiers.Controls the ability to access files and folders. Énumération associée : Unrestricted.Associated enumeration: Unrestricted.

Voir aussi

S’applique à