Directory.GetFiles Méthode

public:
 static cli::array <System::String ^> ^ GetFiles(System::String ^ path);

public static string[] GetFiles(string path);

static member GetFiles : string -> string[]

Public Shared Function GetFiles (path As String) As String()

Paramètres

Retours

Tableau des noms complets (y compris les chemins) des fichiers dans le répertoire spécifié ou un tableau vide si aucun fichier n’est trouvé.

Exceptions

Exemples

L’exemple suivant montre comment utiliser la GetFiles méthode pour retourner des noms de fichiers à partir d’un emplacement spécifié par l’utilisateur. L’exemple est configuré pour intercepter toutes les erreurs communes à cette méthode.

// For Directory.GetFiles and Directory.GetDirectories
// For File.Exists, Directory.Exists
using System;
using System.IO;
using System.Collections;

public class RecursiveFileProcessor
{
    public static void Main(string[] args)
    {
        foreach(string path in args)
        {
            if(File.Exists(path))
            {
                // This path is a file
                ProcessFile(path);
            }
            else if(Directory.Exists(path))
            {
                // This path is a directory
                ProcessDirectory(path);
            }
            else
            {
                Console.WriteLine("{0} is not a valid file or directory.", path);
            }
        }
    }

    // Process all files in the directory passed in, recurse on any directories
    // that are found, and process the files they contain.
    public static void ProcessDirectory(string targetDirectory)
    {
        // Process the list of files found in the directory.
        string [] fileEntries = Directory.GetFiles(targetDirectory);
        foreach(string fileName in fileEntries)
            ProcessFile(fileName);

        // Recurse into subdirectories of this directory.
        string [] subdirectoryEntries = Directory.GetDirectories(targetDirectory);
        foreach(string subdirectory in subdirectoryEntries)
            ProcessDirectory(subdirectory);
    }

    // Insert logic for processing found files here.
    public static void ProcessFile(string path)
    {
        Console.WriteLine("Processed file '{0}'.", path);	
    }
}

module RecursiveFileProcessor

open System.IO

// Insert logic for processing found files here.
let processFile path =
    printfn $"Processed file '%s{path}'."

// Process all files in the directory passed in, recurse on any directories
// that are found, and process the files they contain.
let rec processDirectory targetDirectory =
    // Process the list of files found in the directory.
    let fileEntries = Directory.GetFiles targetDirectory
    for fileName in fileEntries do
        processFile fileName

    // Recurse into subdirectories of this directory.
    let subdirectoryEntries = Directory.GetDirectories targetDirectory
    for subdirectory in subdirectoryEntries do
        processDirectory subdirectory

[<EntryPoint>]
let main args =
    for path in args do
        if File.Exists path then
            // This path is a file
            processFile path
        elif Directory.Exists path then
            // This path is a directory
            processDirectory path
        else
            printfn $"{path} is not a valid file or directory."
    0

' For Directory.GetFiles and Directory.GetDirectories
' For File.Exists, Directory.Exists 

Imports System.IO
Imports System.Collections

Public Class RecursiveFileProcessor

    Public Overloads Shared Sub Main(ByVal args() As String)
        Dim path As String
        For Each path In args
            If File.Exists(path) Then
                ' This path is a file.
                ProcessFile(path)
            Else
                If Directory.Exists(path) Then
                    ' This path is a directory.
                    ProcessDirectory(path)
                Else
                    Console.WriteLine("{0} is not a valid file or directory.", path)
                End If
            End If
        Next path
    End Sub


    ' Process all files in the directory passed in, recurse on any directories 
    ' that are found, and process the files they contain.
    Public Shared Sub ProcessDirectory(ByVal targetDirectory As String)
        Dim fileEntries As String() = Directory.GetFiles(targetDirectory)
        ' Process the list of files found in the directory.
        Dim fileName As String
        For Each fileName In fileEntries
            ProcessFile(fileName)

        Next fileName
        Dim subdirectoryEntries As String() = Directory.GetDirectories(targetDirectory)
        ' Recurse into subdirectories of this directory.
        Dim subdirectory As String
        For Each subdirectory In subdirectoryEntries
            ProcessDirectory(subdirectory)
        Next subdirectory

    End Sub

    ' Insert logic for processing found files here.
    Public Shared Sub ProcessFile(ByVal path As String)
        Console.WriteLine("Processed file '{0}'.", path)
    End Sub
End Class

Remarques

Les EnumerateFiles méthodes diffèrent GetFiles comme suit : Lorsque vous utilisez EnumerateFiles, vous pouvez commencer à énumérer la collection de noms avant que l’ensemble de la collection soit retournée ; lorsque vous utilisez GetFiles, vous devez attendre que l’ensemble du tableau de noms soit retourné avant de pouvoir accéder au tableau. Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateFiles vous pouvez être plus efficace.

Les noms de fichiers retournés sont ajoutés au paramètre fourni path .

Cette méthode est identique à GetFiles(String, String) celle spécifiée par l’astérisque (*) spécifié comme modèle de recherche.

Le path paramètre peut spécifier des informations relatives ou absolues sur le chemin d’accès. Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel. Pour obtenir le répertoire de travail actuel, consultez GetCurrentDirectory.

L’ordre des noms de fichiers retournés n’est pas garanti ; utilisez la Sort méthode si un ordre de tri spécifique est requis.

La sensibilité de la casse du path paramètre correspond à celle du système de fichiers sur lequel le code est en cours d’exécution. Par exemple, il ne respecte pas la casse sur NTFS (le système de fichiers Windows par défaut) et respecte la casse sur les systèmes de fichiers Linux.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches d’E/S courantes.

Voir aussi

• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour écrire du texte dans un fichier

public:
 static cli::array <System::String ^> ^ GetFiles(System::String ^ path, System::String ^ searchPattern);

public static string[] GetFiles(string path, string searchPattern);

static member GetFiles : string * string -> string[]

Public Shared Function GetFiles (path As String, searchPattern As String) As String()

Paramètres

Retours

Tableau des noms complets (y compris les chemins) des fichiers du répertoire spécifié qui correspondent au modèle de recherche spécifié ou à un tableau vide si aucun fichier n’est trouvé.

Exceptions

Exemples

L’exemple suivant compte le nombre de fichiers commençant par la lettre spécifiée.

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        try
        {
            // Only get files that begin with the letter "c".
            string[] dirs = Directory.GetFiles(@"c:\", "c*");
            Console.WriteLine("The number of files starting with c is {0}.", dirs.Length);
            foreach (string dir in dirs)
            {
                Console.WriteLine(dir);
            }
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

open System.IO

try
    // Only get files that begin with the letter "c".
    let dirs = Directory.GetFiles(@"c:\", "c*")
    printfn $"The number of files starting with c is {dirs.Length}."
    for dir in dirs do
        printfn $"{dir}"
with e ->
    printfn $"The process failed: {e}"

Imports System.IO

Public Class Test
    Public Shared Sub Main()
        Try
            ' Only get files that begin with the letter "c".
            Dim dirs As String() = Directory.GetFiles("c:\", "c*")
            Console.WriteLine("The number of files starting with c is {0}.", dirs.Length)
            Dim dir As String
            For Each dir In dirs
                Console.WriteLine(dir)
            Next
        Catch e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

Remarques

Les noms de fichiers retournés sont ajoutés au paramètre fourni path et l’ordre des noms de fichiers retournés n’est pas garanti ; utilisez la Sort méthode si un ordre de tri spécifique est requis.

searchPattern peut être une combinaison de caractères littéraux et génériques, mais elle ne prend pas en charge les expressions régulières. Les spécificateurs génériques suivants sont autorisés dans searchPattern.

Spécificateur de caractères génériques	Correspondances
* (astérisque)	Zéro ou plusieurs caractères dans cette position.
? (point d’interrogation)	Exactement un caractère dans cette position.

Les caractères autres que le caractère générique sont des caractères littérals. Par exemple, la searchPattern chaîne « *t » recherche tous les noms se path terminant par la lettre « t ». La searchPattern chaîne « s* » recherche tous les noms en path commençant par la lettre « s ».

searchPattern ne peut pas se terminer par deux périodes (« .. ») ou contenir deux points (« .. ») suivis DirectorySeparatorChar ou AltDirectorySeparatorChar, ni ne peuvent contenir de caractères non valides. Vous pouvez rechercher des caractères non valides à l’aide de la méthode GetInvalidPathChars.

Les EnumerateFiles méthodes diffèrent GetFiles comme suit : Lorsque vous utilisez EnumerateFiles, vous pouvez commencer à énumérer la collection de noms avant que l’ensemble de la collection soit retournée ; lorsque vous utilisez GetFiles, vous devez attendre que l’ensemble du tableau de noms soit retourné avant de pouvoir accéder au tableau. Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateFiles vous pouvez être plus efficace.

Le path paramètre peut spécifier des informations relatives ou absolues sur le chemin d’accès. Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel. Pour obtenir le répertoire de travail actuel, consultez GetCurrentDirectory.

La sensibilité de la casse du path paramètre correspond à celle du système de fichiers sur lequel le code est en cours d’exécution. Par exemple, il ne respecte pas la casse sur NTFS (le système de fichiers Windows par défaut) et respecte la casse sur les systèmes de fichiers Linux.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches d’E/S courantes.

Voir aussi

• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour écrire du texte dans un fichier

public:
 static cli::array <System::String ^> ^ GetFiles(System::String ^ path, System::String ^ searchPattern, System::IO::EnumerationOptions ^ enumerationOptions);

public static string[] GetFiles(string path, string searchPattern, System.IO.EnumerationOptions enumerationOptions);

static member GetFiles : string * string * System.IO.EnumerationOptions -> string[]

Public Shared Function GetFiles (path As String, searchPattern As String, enumerationOptions As EnumerationOptions) As String()

Paramètres

Retours

Tableau des noms complets (y compris les chemins) des fichiers du répertoire spécifié qui correspondent aux options de recherche et d’énumération spécifiées, ou un tableau vide si aucun fichier n’est trouvé.

Exceptions

Remarques

Les noms de fichiers retournés sont ajoutés au paramètre fourni path et l’ordre des noms de fichiers retournés n’est pas garanti ; utilisez la Sort méthode si un ordre de tri spécifique est requis.

searchPattern peut être une combinaison de caractères littéraux et génériques, mais elle ne prend pas en charge les expressions régulières. Les spécificateurs génériques suivants sont autorisés dans searchPattern.

Spécificateur de caractères génériques	Correspondances
* (astérisque)	Zéro ou plusieurs caractères dans cette position.
? (point d’interrogation)	Exactement un caractère dans cette position.

Les caractères autres que le caractère générique sont des caractères littérals. Par exemple, la searchPattern chaîne « *t » recherche tous les noms se path terminant par la lettre « t ». La searchPattern chaîne « s* » recherche tous les noms en path commençant par la lettre « s ».

searchPattern ne peut pas se terminer par deux périodes (« .. ») ou contenir deux points (« .. ») suivis DirectorySeparatorChar ou AltDirectorySeparatorChar, ni ne peuvent contenir de caractères non valides. Vous pouvez rechercher des caractères non valides à l’aide de la méthode GetInvalidPathChars.

Les EnumerateFiles méthodes diffèrent GetFiles comme suit : Lorsque vous utilisez EnumerateFiles, vous pouvez commencer à énumérer la collection de noms avant que l’ensemble de la collection soit retournée ; lorsque vous utilisez GetFiles, vous devez attendre que l’ensemble du tableau de noms soit retourné avant de pouvoir accéder au tableau. Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateFiles vous pouvez être plus efficace.

Le path paramètre peut spécifier des informations relatives ou absolues sur le chemin d’accès. Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel. Pour obtenir le répertoire de travail actuel, consultez GetCurrentDirectory.

La sensibilité de la casse du path paramètre correspond à celle du système de fichiers sur lequel le code est en cours d’exécution. Par exemple, il ne respecte pas la casse sur NTFS (le système de fichiers Windows par défaut) et respecte la casse sur les systèmes de fichiers Linux.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches d’E/S courantes.

public:
 static cli::array <System::String ^> ^ GetFiles(System::String ^ path, System::String ^ searchPattern, System::IO::SearchOption searchOption);

public static string[] GetFiles(string path, string searchPattern, System.IO.SearchOption searchOption);

static member GetFiles : string * string * System.IO.SearchOption -> string[]

Public Shared Function GetFiles (path As String, searchPattern As String, searchOption As SearchOption) As String()

Paramètres

Retours

Tableau des noms complets (y compris les chemins) des fichiers du répertoire spécifié qui correspondent au modèle et à l’option de recherche spécifiés, ou à un tableau vide si aucun fichier n’est trouvé.

Exceptions

Remarques

Les noms de fichiers retournés sont ajoutés au paramètre path fourni et l’ordre des noms de fichiers retournés n’est pas garanti ; utilisez la Sort méthode si un ordre de tri spécifique est requis.

searchPattern peut être une combinaison de caractères littéraux et génériques, mais elle ne prend pas en charge les expressions régulières. Les spécificateurs génériques suivants sont autorisés dans searchPattern.

Spécificateur de caractères génériques	Correspondances
* (astérisque)	Zéro ou plusieurs caractères dans cette position.
? (point d’interrogation)	Exactement un caractère dans cette position.

Les caractères autres que le caractère générique sont des caractères littérals. Par exemple, la searchPattern chaîne « *t » recherche tous les noms se path terminant par la lettre « t ». La searchPattern chaîne « s* » recherche tous les noms en path commençant par la lettre « s ».

searchPattern ne peut pas se terminer par deux périodes (« .. ») ou contenir deux points (« .. ») suivis DirectorySeparatorChar ou AltDirectorySeparatorChar, ni ne peuvent contenir de caractères non valides. Vous pouvez rechercher des caractères non valides à l’aide de la méthode GetInvalidPathChars.

Les EnumerateFiles méthodes diffèrent GetFiles comme suit : Lorsque vous utilisez EnumerateFiles, vous pouvez commencer à énumérer la collection de noms avant que l’ensemble de la collection soit retournée ; lorsque vous utilisez GetFiles, vous devez attendre que l’ensemble du tableau de noms soit retourné avant de pouvoir accéder au tableau. Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateFiles vous pouvez être plus efficace.

Les noms de fichiers incluent le chemin d’accès complet.

Le path paramètre peut spécifier des informations relatives ou absolues sur le chemin d’accès. Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel. Pour obtenir le répertoire de travail actuel, consultez GetCurrentDirectory.

La sensibilité de la casse du path paramètre correspond à celle du système de fichiers sur lequel le code est en cours d’exécution. Par exemple, il ne respecte pas la casse sur NTFS (le système de fichiers Windows par défaut) et respecte la casse sur les systèmes de fichiers Linux.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches d’E/S courantes.

Voir aussi

• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour écrire du texte dans un fichier