DirectoryInfo.EnumerateFiles Méthode

Référence

Définition

Espace de noms:: System.IO

Assemblys:: mscorlib.dll, System.IO.FileSystem.dll

Assembly:: System.IO.FileSystem.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Retourne une collection énumérable d'informations de fichiers dans le répertoire actif.

Surcharges

EnumerateFiles()	Retourne une collection énumérable d'informations de fichiers dans le répertoire actif.
EnumerateFiles(String)	Retourne une collection énumérable d'informations sur le fichier qui correspond à un modèle de recherche.
EnumerateFiles(String, EnumerationOptions)	Retourne une collection énumérable d'informations de fichier qui correspond au modèle de recherche et aux options d’énumération que vous spécifiez.
EnumerateFiles(String, SearchOption)	Retourne une collection énumérable d'informations de fichier qui correspond à un modèle de recherche spécifié et à une option de recherche de sous-répertoires.

EnumerateFiles()

Source:: DirectoryInfo.cs

Source:: DirectoryInfo.cs

Source:: DirectoryInfo.cs

Retourne une collection énumérable d'informations de fichiers dans le répertoire actif.

public:
 System::Collections::Generic::IEnumerable<System::IO::FileInfo ^> ^ EnumerateFiles();

public System.Collections.Generic.IEnumerable<System.IO.FileInfo> EnumerateFiles ();

member this.EnumerateFiles : unit -> seq<System.IO.FileInfo>

Public Function EnumerateFiles () As IEnumerable(Of FileInfo)

Retours

IEnumerable<FileInfo>

Collection énumérable des fichiers dans le répertoire actuel.

Exceptions

DirectoryNotFoundException

Le chemin d’accès encapsulé dans l’objet DirectoryInfo n’est pas valide (par exemple, il est sur un lecteur non mappé).

SecurityException

L'appelant n'a pas l'autorisation requise.

Exemples

L’exemple suivant énumère les fichiers sous un répertoire spécifié et utilise une requête LINQ pour renvoyer les noms de tous les fichiers qui ont été créés avant 2009 en vérifiant la valeur de la CreationTimeUtc propriété.

Si vous avez uniquement besoin des noms des fichiers, utilisez la classe statique Directory pour de meilleures performances. Pour obtenir un exemple, consultez la Directory.EnumerateFiles(String) méthode .

// Create a DirectoryInfo of the directory of the files to enumerate.
DirectoryInfo DirInfo = new DirectoryInfo(@"\\archives1\library\");

DateTime StartOf2009 = new DateTime(2009, 01, 01);

// LINQ query for all files created before 2009.
var files = from f in DirInfo.EnumerateFiles()
           where f.CreationTimeUtc < StartOf2009
           select f;

// Show results.
foreach (var f in files)
{
    Console.WriteLine("{0}", f.Name);
}

// Create a DirectoryInfo of the directory of the files to enumerate.
let dirInfo = DirectoryInfo @"\archives1\library\"

let startOf2009 = DateTime(2009, 01, 01)

// LINQ query for all files created before 2009.
let files = 
    query {
        for f in dirInfo.EnumerateFiles() do
        where (f.CreationTime < startOf2009)
        select f
    }

// Show results.
for f in files do
    printfn $"{f.Name}"

' Create a DirectoryInfo of the directory of the files to enumerate.
Dim DirInfo As New DirectoryInfo("\\archives1\library\")

Dim StartOf2009 As New DateTime(2009, 1, 1)

' LINQ query for all files created before 2009.
Dim files = From f In DirInfo.EnumerateFiles()
            Where f.CreationTimeUtc < StartOf2009

' Show results.
For Each f As FileInfo In files
    Console.WriteLine("{0}", f.Name)
Next

L’exemple suivant montre comment énumérer des fichiers dans un répertoire à l’aide de différentes options de recherche. L’exemple suppose un répertoire qui contient des fichiers nommés log1.txt, log2.txt, test1.txt, test2.txt, test3.txt et un sous-répertoire contenant un fichier nommé SubFile.txt.

using System;
using System.IO;

namespace ConsoleApplication1
{
    class Program
    {
        static void Main(string[] args)
        {
            DirectoryInfo di = new DirectoryInfo(@"C:\ExampleDir");
            Console.WriteLine("No search pattern returns:");
            foreach (var fi in di.EnumerateFiles())
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern *2* returns:");
            foreach (var fi in di.EnumerateFiles("*2*"))
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern test?.txt returns:");
            foreach (var fi in di.EnumerateFiles("test?.txt"))
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern AllDirectories returns:");
            foreach (var fi in di.EnumerateFiles("*", SearchOption.AllDirectories))
            {
                Console.WriteLine(fi.Name);
            }
        }
    }
}
/*
This code produces output similar to the following:

No search pattern returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt

Search pattern *2* returns:
log2.txt
test2.txt

Search pattern test?.txt returns:
test1.txt
test2.txt
test3.txt

Search pattern AllDirectories returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt
SubFile.txt
Press any key to continue . . .

*/

open System.IO

let di = DirectoryInfo @"C:\ExampleDir"
printfn "No search pattern returns:"
for fi in di.EnumerateFiles() do
    printfn $"{fi.Name}"

printfn "\nSearch pattern *2* returns:"
for fi in di.EnumerateFiles "*2*" do
    printfn $"{fi.Name}"

printfn "\nSearch pattern test?.txt returns:"
for fi in di.EnumerateFiles "test?.txt" do
    printfn $"{fi.Name}"

printfn "\nSearch pattern AllDirectories returns:"
for fi in di.EnumerateFiles("*", SearchOption.AllDirectories) do
    printfn $"{fi.Name}"
(*
This code produces output similar to the following:

No search pattern returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt

Search pattern *2* returns:
log2.txt
test2.txt

Search pattern test?.txt returns:
test1.txt
test2.txt
test3.txt

Search pattern AllDirectories returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt
SubFile.txt
Press any key to continue . . .
*)

Imports System.IO

Module Module1

    Sub Main()
        Dim di As DirectoryInfo = New DirectoryInfo("C:\ExampleDir")
        Console.WriteLine("No search pattern returns:")
        For Each fi In di.EnumerateFiles()
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern *2* returns:")
        For Each fi In di.EnumerateFiles("*2*")
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern test?.txt returns:")
        For Each fi In di.EnumerateFiles("test?.txt")
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern AllDirectories returns:")
        For Each fi In di.EnumerateFiles("*", SearchOption.AllDirectories)
            Console.WriteLine(fi.Name)
        Next
    End Sub

End Module

' This code produces output similar to the following:

' No search pattern returns:
' log1.txt
' log2.txt
' test1.txt
' test2.txt
' test3.txt

' Search pattern *2* returns:
' log2.txt
' test2.txt

' Search pattern test?.txt returns:
' test1.txt
' test2.txt
' test3.txt

' Search pattern AllDirectories returns:
' log1.txt
' log2.txt
' test1.txt
' test2.txt
' test3.txt
' SubFile.txt
' Press any key to continue . . .

Remarques

Les EnumerateFiles méthodes et GetFiles diffèrent comme suit :

Lorsque vous utilisez EnumerateFiles, vous pouvez commencer à énumérer la collection d’objets avant que FileInfo la collection entière ne soit retournée.
Lorsque vous utilisez GetFiles, vous devez attendre que l’ensemble du tableau d’objets soit retourné avant de FileInfo pouvoir accéder au tableau.

Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateFiles peut être plus efficace.

Cette méthode pré-remplit les valeurs des propriétés suivantes FileInfo :

La collection retournée n’est pas mise en cache ; chaque appel à la GetEnumerator méthode sur la collection démarre une nouvelle énumération.

S’applique à

EnumerateFiles(String)

Source:: DirectoryInfo.cs

Source:: DirectoryInfo.cs

Source:: DirectoryInfo.cs

Retourne une collection énumérable d'informations sur le fichier qui correspond à un modèle de recherche.

public:
 System::Collections::Generic::IEnumerable<System::IO::FileInfo ^> ^ EnumerateFiles(System::String ^ searchPattern);

public System.Collections.Generic.IEnumerable<System.IO.FileInfo> EnumerateFiles (string searchPattern);

member this.EnumerateFiles : string -> seq<System.IO.FileInfo>

Public Function EnumerateFiles (searchPattern As String) As IEnumerable(Of FileInfo)

Paramètres

searchPattern: String

Chaîne recherchée à trouver parmi les noms de fichiers. Ce paramètre peut contenir une combinaison d’un chemin littéral valide et de caractères génériques (* et ?), mais il ne prend pas en charge les expressions régulières.

Retours

IEnumerable<FileInfo>

Collection énumérable de fichiers qui correspond à searchPattern.

Exceptions

ArgumentNullException

searchPattern a la valeur null.

DirectoryNotFoundException

Le chemin d’accès encapsulé dans l’objet DirectoryInfo n’est pas valide (par exemple, il est sur un lecteur non mappé).

SecurityException

L'appelant n'a pas l'autorisation requise.

Exemples

using System;
using System.IO;

namespace ConsoleApplication1
{
    class Program
    {
        static void Main(string[] args)
        {
            DirectoryInfo di = new DirectoryInfo(@"C:\ExampleDir");
            Console.WriteLine("No search pattern returns:");
            foreach (var fi in di.EnumerateFiles())
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern *2* returns:");
            foreach (var fi in di.EnumerateFiles("*2*"))
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern test?.txt returns:");
            foreach (var fi in di.EnumerateFiles("test?.txt"))
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern AllDirectories returns:");
            foreach (var fi in di.EnumerateFiles("*", SearchOption.AllDirectories))
            {
                Console.WriteLine(fi.Name);
            }
        }
    }
}
/*
This code produces output similar to the following:

No search pattern returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt

Search pattern *2* returns:
log2.txt
test2.txt

Search pattern test?.txt returns:
test1.txt
test2.txt
test3.txt

Search pattern AllDirectories returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt
SubFile.txt
Press any key to continue . . .

*/

open System.IO

let di = DirectoryInfo @"C:\ExampleDir"
printfn "No search pattern returns:"
for fi in di.EnumerateFiles() do
    printfn $"{fi.Name}"

printfn "\nSearch pattern *2* returns:"
for fi in di.EnumerateFiles "*2*" do
    printfn $"{fi.Name}"

printfn "\nSearch pattern test?.txt returns:"
for fi in di.EnumerateFiles "test?.txt" do
    printfn $"{fi.Name}"

printfn "\nSearch pattern AllDirectories returns:"
for fi in di.EnumerateFiles("*", SearchOption.AllDirectories) do
    printfn $"{fi.Name}"
(*
This code produces output similar to the following:

No search pattern returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt

Search pattern *2* returns:
log2.txt
test2.txt

Search pattern test?.txt returns:
test1.txt
test2.txt
test3.txt

Search pattern AllDirectories returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt
SubFile.txt
Press any key to continue . . .
*)

Imports System.IO

Module Module1

    Sub Main()
        Dim di As DirectoryInfo = New DirectoryInfo("C:\ExampleDir")
        Console.WriteLine("No search pattern returns:")
        For Each fi In di.EnumerateFiles()
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern *2* returns:")
        For Each fi In di.EnumerateFiles("*2*")
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern test?.txt returns:")
        For Each fi In di.EnumerateFiles("test?.txt")
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern AllDirectories returns:")
        For Each fi In di.EnumerateFiles("*", SearchOption.AllDirectories)
            Console.WriteLine(fi.Name)
        Next
    End Sub

End Module

' This code produces output similar to the following:

' No search pattern returns:
' log1.txt
' log2.txt
' test1.txt
' test2.txt
' test3.txt

' Search pattern *2* returns:
' log2.txt
' test2.txt

' Search pattern test?.txt returns:
' test1.txt
' test2.txt
' test3.txt

' Search pattern AllDirectories returns:
' log1.txt
' log2.txt
' test1.txt
' test2.txt
' test3.txt
' SubFile.txt
' Press any key to continue . . .

Remarques

searchPattern peut être une combinaison de caractères littéral 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 générique	Correspond à
* (astérisque)	Zéro ou plus caractères dans cette position.
? (point d’interrogation)	Zéro ou 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 chaîne « *t » recherche tous les noms se terminant par la lettre « t ». ". La searchPattern chaîne « s* » recherche tous les noms en path commençant par la lettre « s ».

Les EnumerateFiles méthodes et GetFiles diffèrent comme suit :

Lorsque vous utilisez EnumerateFiles, vous pouvez commencer à énumérer la collection d’objets avant que FileInfo la collection entière ne soit retournée.
Lorsque vous utilisez GetFiles, vous devez attendre que l’ensemble du tableau d’objets soit retourné avant de FileInfo pouvoir accéder au tableau.

Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateFiles peut être plus efficace.

Cette méthode pré-remplit les valeurs des propriétés suivantes FileInfo :

La collection retournée n’est pas mise en cache ; chaque appel à la GetEnumerator méthode sur la collection démarre une nouvelle énumération.

S’applique à

EnumerateFiles(String, EnumerationOptions)

Source:: DirectoryInfo.cs

Source:: DirectoryInfo.cs

Source:: DirectoryInfo.cs

Retourne une collection énumérable d'informations de fichier qui correspond au modèle de recherche et aux options d’énumération que vous spécifiez.

public:
 System::Collections::Generic::IEnumerable<System::IO::FileInfo ^> ^ EnumerateFiles(System::String ^ searchPattern, System::IO::EnumerationOptions ^ enumerationOptions);

public System.Collections.Generic.IEnumerable<System.IO.FileInfo> EnumerateFiles (string searchPattern, System.IO.EnumerationOptions enumerationOptions);

member this.EnumerateFiles : string * System.IO.EnumerationOptions -> seq<System.IO.FileInfo>

Public Function EnumerateFiles (searchPattern As String, enumerationOptions As EnumerationOptions) As IEnumerable(Of FileInfo)

Paramètres

searchPattern: String

enumerationOptions: EnumerationOptions

Objet qui décrit la configuration de recherche et d’énumération à utiliser.

Retours

IEnumerable<FileInfo>

Collection énumérable de fichiers qui correspond à searchPattern et à enumerationOptions.

Exceptions

ArgumentNullException

searchPattern a la valeur null.

DirectoryNotFoundException

Le chemin d’accès encapsulé dans l’objet DirectoryInfo n’est pas valide (par exemple, il est sur un lecteur non mappé).

SecurityException

L'appelant n'a pas l'autorisation requise.

Remarques

Spécificateur générique	Correspond à
* (astérisque)	Zéro ou plus caractères dans cette position.
? (point d’interrogation)	Zéro ou un caractère dans cette position.

Les EnumerateFiles méthodes et GetFiles diffèrent comme suit :

Lorsque vous utilisez EnumerateFiles, vous pouvez commencer à énumérer la collection d’objets avant que FileInfo la collection entière ne soit retournée.
Lorsque vous utilisez GetFiles, vous devez attendre que l’ensemble du tableau d’objets soit retourné avant de FileInfo pouvoir accéder au tableau.

Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateFiles peut être plus efficace.

Cette méthode pré-remplit les valeurs des propriétés suivantes FileInfo :

La collection retournée n’est pas mise en cache ; chaque appel à la GetEnumerator méthode sur la collection démarre une nouvelle énumération.

S’applique à

EnumerateFiles(String, SearchOption)

Source:: DirectoryInfo.cs

Source:: DirectoryInfo.cs

Source:: DirectoryInfo.cs

Retourne une collection énumérable d'informations de fichier qui correspond à un modèle de recherche spécifié et à une option de recherche de sous-répertoires.

public:
 System::Collections::Generic::IEnumerable<System::IO::FileInfo ^> ^ EnumerateFiles(System::String ^ searchPattern, System::IO::SearchOption searchOption);

public System.Collections.Generic.IEnumerable<System.IO.FileInfo> EnumerateFiles (string searchPattern, System.IO.SearchOption searchOption);

member this.EnumerateFiles : string * System.IO.SearchOption -> seq<System.IO.FileInfo>

Public Function EnumerateFiles (searchPattern As String, searchOption As SearchOption) As IEnumerable(Of FileInfo)

Paramètres

searchPattern: String

searchOption: SearchOption

L'une des valeurs d'énumération qui spécifie si l'opération de recherche doit inclure uniquement le répertoire actif ou tous les sous-répertoires. La valeur par défaut est TopDirectoryOnly.

Retours

IEnumerable<FileInfo>

Collection énumérable de fichiers qui correspond à searchPattern et à searchOption.

Exceptions

ArgumentNullException

searchPattern a la valeur null.

ArgumentOutOfRangeException

searchOption n’est pas une valeur de SearchOption valide.

DirectoryNotFoundException

Le chemin d’accès encapsulé dans l’objet DirectoryInfo n’est pas valide (par exemple, il est sur un lecteur non mappé).

SecurityException

L'appelant n'a pas l'autorisation requise.

Exemples

using System;
using System.IO;

namespace ConsoleApplication1
{
    class Program
    {
        static void Main(string[] args)
        {
            DirectoryInfo di = new DirectoryInfo(@"C:\ExampleDir");
            Console.WriteLine("No search pattern returns:");
            foreach (var fi in di.EnumerateFiles())
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern *2* returns:");
            foreach (var fi in di.EnumerateFiles("*2*"))
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern test?.txt returns:");
            foreach (var fi in di.EnumerateFiles("test?.txt"))
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern AllDirectories returns:");
            foreach (var fi in di.EnumerateFiles("*", SearchOption.AllDirectories))
            {
                Console.WriteLine(fi.Name);
            }
        }
    }
}
/*
This code produces output similar to the following:

No search pattern returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt

Search pattern *2* returns:
log2.txt
test2.txt

Search pattern test?.txt returns:
test1.txt
test2.txt
test3.txt

Search pattern AllDirectories returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt
SubFile.txt
Press any key to continue . . .

*/

open System.IO

let di = DirectoryInfo @"C:\ExampleDir"
printfn "No search pattern returns:"
for fi in di.EnumerateFiles() do
    printfn $"{fi.Name}"

printfn "\nSearch pattern *2* returns:"
for fi in di.EnumerateFiles "*2*" do
    printfn $"{fi.Name}"

printfn "\nSearch pattern test?.txt returns:"
for fi in di.EnumerateFiles "test?.txt" do
    printfn $"{fi.Name}"

printfn "\nSearch pattern AllDirectories returns:"
for fi in di.EnumerateFiles("*", SearchOption.AllDirectories) do
    printfn $"{fi.Name}"
(*
This code produces output similar to the following:

No search pattern returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt

Search pattern *2* returns:
log2.txt
test2.txt

Search pattern test?.txt returns:
test1.txt
test2.txt
test3.txt

Search pattern AllDirectories returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt
SubFile.txt
Press any key to continue . . .
*)

Imports System.IO

Module Module1

    Sub Main()
        Dim di As DirectoryInfo = New DirectoryInfo("C:\ExampleDir")
        Console.WriteLine("No search pattern returns:")
        For Each fi In di.EnumerateFiles()
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern *2* returns:")
        For Each fi In di.EnumerateFiles("*2*")
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern test?.txt returns:")
        For Each fi In di.EnumerateFiles("test?.txt")
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern AllDirectories returns:")
        For Each fi In di.EnumerateFiles("*", SearchOption.AllDirectories)
            Console.WriteLine(fi.Name)
        Next
    End Sub

End Module

' This code produces output similar to the following:

' No search pattern returns:
' log1.txt
' log2.txt
' test1.txt
' test2.txt
' test3.txt

' Search pattern *2* returns:
' log2.txt
' test2.txt

' Search pattern test?.txt returns:
' test1.txt
' test2.txt
' test3.txt

' Search pattern AllDirectories returns:
' log1.txt
' log2.txt
' test1.txt
' test2.txt
' test3.txt
' SubFile.txt
' Press any key to continue . . .

Remarques

Spécificateur générique	Correspond à
* (astérisque)	Zéro ou plus caractères dans cette position.
? (point d’interrogation)	Zéro ou un caractère dans cette position.

Les EnumerateFiles méthodes et GetFiles diffèrent comme suit :

Lorsque vous utilisez EnumerateFiles, vous pouvez commencer à énumérer la collection d’objets avant que FileInfo la collection entière ne soit retournée.
Lorsque vous utilisez GetFiles, vous devez attendre que l’ensemble du tableau d’objets FileInfo soit retourné avant de pouvoir accéder au tableau.

Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateFiles peut être plus efficace.

Cette méthode préremplit les valeurs des propriétés suivantes FileInfo :

La collection retournée n’est pas mise en cache ; chaque appel à la GetEnumerator méthode sur la collection démarre une nouvelle énumération.

S’applique à

Partager via

DirectoryInfo.EnumerateFiles Méthode

Définition

Surcharges

EnumerateFiles()

Retours

Exceptions

Exemples

Remarques

S’applique à

EnumerateFiles(String)

Paramètres

Retours

Exceptions

Exemples

Remarques

S’applique à

EnumerateFiles(String, EnumerationOptions)

Paramètres

Retours

Exceptions

Remarques

S’applique à

EnumerateFiles(String, SearchOption)

Paramètres

Retours

Exceptions

Exemples

Remarques

S’applique à

Ressources supplémentaires