DirectoryInfo.EnumerateFiles Methode

Definitie

Naamruimte:: System.IO

Assembly's:: mscorlib.dll, System.IO.FileSystem.dll

Assembly:: mscorlib.dll

Assembly:: System.IO.FileSystem.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Retourneert een inventariserbare verzameling bestandsgegevens in de huidige map.

Overloads

Name	Description
EnumerateFiles()	Retourneert een inventariserbare verzameling bestandsgegevens in de huidige map.
EnumerateFiles(String)	Retourneert een inventariserbare verzameling bestandsgegevens die overeenkomt met een zoekpatroon.
EnumerateFiles(String, EnumerationOptions)	Retourneert een inventariserbare verzameling bestandsgegevens die overeenkomen met het opgegeven zoekpatroon en de opsommingsopties.
EnumerateFiles(String, SearchOption)	Retourneert een inventariserbare verzameling bestandsgegevens die overeenkomen met een opgegeven zoekpatroon en zoeksubmapoptie.

EnumerateFiles()

Retourneert een inventariserbare verzameling bestandsgegevens in de huidige map.

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)

Retouren

IEnumerable<FileInfo>

Een inventariserbare verzameling van de bestanden in de huidige map.

Uitzonderingen

DirectoryNotFoundException

Het pad dat in het DirectoryInfo object is ingekapseld, is ongeldig (bijvoorbeeld op een niet-toegewezen station).

SecurityException

De beller heeft niet de vereiste machtiging.

Voorbeelden

In het volgende voorbeeld worden de bestanden in een opgegeven map opgesomd en wordt een LINQ-query gebruikt om de namen te retourneren van alle bestanden die vóór 2009 zijn gemaakt door de waarde van de CreationTimeUtc eigenschap te controleren.

Als u alleen de namen van de bestanden nodig hebt, gebruikt u de statische Directory klasse voor betere prestaties. Zie de Directory.EnumerateFiles(String) methode voor een voorbeeld.

// 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

In het volgende voorbeeld ziet u hoe u bestanden in een map opsommen met behulp van verschillende zoekopties. In het voorbeeld wordt uitgegaan van een map met bestanden met de naam log1.txt, log2.txt, test1.txt, test2.txt, test3.txten een submap met een bestand met de naam 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 . . .

Opmerkingen

De EnumerateFiles en GetFiles methoden verschillen als volgt:

Wanneer u dit gebruikt EnumerateFiles, kunt u beginnen met het inventariseren van FileInfo de verzameling objecten voordat de hele verzameling wordt geretourneerd.
Wanneer u deze functie gebruikt GetFiles, moet u wachten totdat de hele matrix met FileInfo objecten wordt geretourneerd voordat u toegang hebt tot de matrix.

Daarom kan het efficiënter zijn wanneer u met veel bestanden en mappen EnumerateFiles werkt.

Met deze methode worden de waarden van de volgende FileInfo eigenschappen vooraf ingevuld:

De geretourneerde verzameling wordt niet in de cache opgeslagen; elke aanroep van de GetEnumerator methode in de verzameling start een nieuwe opsomming.

Van toepassing op

EnumerateFiles(String)

Retourneert een inventariserbare verzameling bestandsgegevens die overeenkomt met een zoekpatroon.

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)

Parameters

searchPattern: String

De zoekreeks die overeenkomt met de namen van bestanden. Deze parameter kan een combinatie van geldig letterlijke tekens en jokertekens (* en ?) bevatten, maar biedt geen ondersteuning voor reguliere expressies.

Retouren

IEnumerable<FileInfo>

Een inventariserbare verzameling bestanden die overeenkomen met searchPattern.

Uitzonderingen

ArgumentNullException

searchPattern is null.

DirectoryNotFoundException

Het pad dat in het DirectoryInfo object is ingekapseld, is ongeldig (bijvoorbeeld op een niet-toegewezen station).

SecurityException

De beller heeft niet de vereiste machtiging.

Voorbeelden

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 . . .

Opmerkingen

searchPattern kan een combinatie zijn van letterlijke tekens en jokertekens, maar biedt geen ondersteuning voor reguliere expressies. De volgende jokertekenaanduidingen zijn toegestaan in searchPattern.

Jokertekenaanduiding	Overeenkomsten
* (sterretje)	Nul of meer tekens op die positie.
? (vraagteken)	Nul of één teken op die positie.

Andere tekens dan het jokerteken zijn letterlijke tekens. Met de tekenreeks '*t' wordt bijvoorbeeld gezocht naar alle namen die eindigen op de letter 't'. ". De searchPattern tekenreeks 's*' zoekt naar alle namen in path het begin met de letter 's'.

De EnumerateFiles en GetFiles methoden verschillen als volgt:

Wanneer u dit gebruikt EnumerateFiles, kunt u beginnen met het inventariseren van FileInfo de verzameling objecten voordat de hele verzameling wordt geretourneerd.
Wanneer u deze functie gebruikt GetFiles, moet u wachten totdat de hele matrix met FileInfo objecten wordt geretourneerd voordat u toegang hebt tot de matrix.

Daarom kan het efficiënter zijn wanneer u met veel bestanden en mappen EnumerateFiles werkt.

Met deze methode worden de waarden van de volgende FileInfo eigenschappen vooraf ingevuld:

De geretourneerde verzameling wordt niet in de cache opgeslagen; elke aanroep van de GetEnumerator methode in de verzameling start een nieuwe opsomming.

Van toepassing op

EnumerateFiles(String, EnumerationOptions)

Retourneert een inventariserbare verzameling bestandsgegevens die overeenkomen met het opgegeven zoekpatroon en de opsommingsopties.

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)

Parameters

searchPattern: String

enumerationOptions: EnumerationOptions

Een object dat de zoek- en opsommingsconfiguratie beschrijft die moet worden gebruikt.

Retouren

IEnumerable<FileInfo>

Een inventariserbare verzameling bestanden die overeenkomen searchPattern met en enumerationOptions.

Uitzonderingen

ArgumentNullException

searchPattern is null.

DirectoryNotFoundException

Het pad dat in het DirectoryInfo object is ingekapseld, is ongeldig (bijvoorbeeld op een niet-toegewezen station).

SecurityException

De beller heeft niet de vereiste machtiging.

Opmerkingen

Jokertekenaanduiding	Overeenkomsten
* (sterretje)	Nul of meer tekens op die positie.
? (vraagteken)	Nul of één teken op die positie.

De EnumerateFiles en GetFiles methoden verschillen als volgt:

Wanneer u dit gebruikt EnumerateFiles, kunt u beginnen met het inventariseren van FileInfo de verzameling objecten voordat de hele verzameling wordt geretourneerd.
Wanneer u deze functie gebruikt GetFiles, moet u wachten totdat de hele matrix met FileInfo objecten wordt geretourneerd voordat u toegang hebt tot de matrix.

Daarom kan het efficiënter zijn wanneer u met veel bestanden en mappen EnumerateFiles werkt.

Met deze methode worden de waarden van de volgende FileInfo eigenschappen vooraf ingevuld:

De geretourneerde verzameling wordt niet in de cache opgeslagen; elke aanroep van de GetEnumerator methode in de verzameling start een nieuwe opsomming.

Van toepassing op

EnumerateFiles(String, SearchOption)

Retourneert een inventariserbare verzameling bestandsgegevens die overeenkomen met een opgegeven zoekpatroon en zoeksubmapoptie.

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)

Parameters

searchPattern: String

searchOption: SearchOption

Een van de opsommingswaarden die aangeeft of de zoekbewerking alleen de huidige map of alle submappen moet bevatten. De standaardwaarde is TopDirectoryOnly.

Retouren

IEnumerable<FileInfo>

Een inventariserbare verzameling bestanden die overeenkomen searchPattern met en searchOption.

Uitzonderingen

ArgumentNullException

searchPattern is null.

ArgumentOutOfRangeException

searchOption is geen geldige SearchOption waarde.

DirectoryNotFoundException

Het pad dat in het DirectoryInfo object is ingekapseld, is ongeldig (bijvoorbeeld op een niet-toegewezen station).

SecurityException

De beller heeft niet de vereiste machtiging.

Voorbeelden

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 . . .

Opmerkingen

Jokertekenaanduiding	Overeenkomsten
* (sterretje)	Nul of meer tekens op die positie.
? (vraagteken)	Nul of één teken op die positie.

De EnumerateFiles en GetFiles methoden verschillen als volgt:

Wanneer u dit gebruikt EnumerateFiles, kunt u beginnen met het inventariseren van FileInfo de verzameling objecten voordat de hele verzameling wordt geretourneerd.
Wanneer u deze functie gebruikt GetFiles, moet u wachten totdat de hele matrix met FileInfo objecten wordt geretourneerd voordat u toegang hebt tot de matrix.

Daarom kan het efficiënter zijn wanneer u met veel bestanden en mappen EnumerateFiles werkt.

Met deze methode worden de waarden van de volgende FileInfo eigenschappen vooraf ingevuld:

De geretourneerde verzameling wordt niet in de cache opgeslagen; elke aanroep van de GetEnumerator methode in de verzameling start een nieuwe opsomming.

Van toepassing op

Feedback

Is deze pagina nuttig?