DirectoryInfo.EnumerateFiles 方法

参考

定义

命名空间:: System.IO

程序集:: mscorlib.dll, System.IO.FileSystem.dll

程序集:: System.IO.FileSystem.dll

程序集:: System.Runtime.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

返回当前目录中的文件信息的可枚举集合。

重载

EnumerateFiles()	返回当前目录中的文件信息的可枚举集合。
EnumerateFiles(String)	返回与搜索模式匹配的文件信息的可枚举集合。
EnumerateFiles(String, EnumerationOptions)	返回与指定的搜索模式和枚举选项匹配的文件信息的可枚举集合。
EnumerateFiles(String, SearchOption)	返回与指定的搜索模式和搜索子目录选项匹配的文件信息的可枚举集合。

EnumerateFiles()

Source:: DirectoryInfo.cs

Source:: DirectoryInfo.cs

Source:: DirectoryInfo.cs

返回当前目录中的文件信息的可枚举集合。

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)

IEnumerable<FileInfo>

当前目录中的文件的可枚举集合。

例外

DirectoryNotFoundException

封装在 DirectoryInfo 对象中的路径无效（例如，它位于未映射的驱动器上）。

SecurityException

调用方没有所要求的权限。

示例

以下示例枚举指定目录下的文件，并使用 LINQ 查询通过检查属性的值 CreationTimeUtc 返回 2009 年之前创建的所有文件的名称。

如果只需要文件的名称，请使用静态 Directory 类来提高性能。有关示例，请参阅 Directory.EnumerateFiles(String) 方法。

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

以下示例演示如何使用不同的搜索选项枚举目录中的文件。该示例假定一个目录具有名为 log1.txt、log2.txt、test1.txt、test2.txt、test3.txt 的文件，以及一个名为 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 . . .

注解

EnumerateFiles和 GetFiles 方法的不同之处如下：

使用 EnumerateFiles时，可以在返回整个集合 FileInfo 之前开始枚举对象的集合。
使用 GetFiles时，必须等待整个对象数组 FileInfo 返回，然后才能访问数组。

因此，在使用许多文件和目录时， EnumerateFiles 可以更高效。

此方法预填充以下 FileInfo 属性的值：

未缓存返回的集合;每次对集合上的方法的调用 GetEnumerator 都将启动一个新的枚举。

适用于

EnumerateFiles(String)

Source:: DirectoryInfo.cs

Source:: DirectoryInfo.cs

Source:: DirectoryInfo.cs

返回与搜索模式匹配的文件信息的可枚举集合。

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)

参数

searchPattern: String

要与文件名匹配的搜索字符串。此参数可以包含有效文本路径和通配符（* 和 ?）的组合，但不支持正则表达式。

IEnumerable<FileInfo>

与 searchPattern 匹配的文件的可枚举集合。

例外

ArgumentNullException

searchPattern 为 null。

DirectoryNotFoundException

封装在 DirectoryInfo 对象中的路径无效（例如，它位于未映射的驱动器上）。

SecurityException

调用方没有所要求的权限。

示例

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

注解

searchPattern 可以是文本和通配符的组合，但它不支持正则表达式。允许在中 searchPattern使用以下通配符说明符。

通配符说明符	匹配
*（星号）	该位置的零个或多个字符。
? （问号）	该位置的零个字符或一个字符。

通配符以外的字符是文本字符。例如，字符串“*t”搜索以字母“t”结尾的所有名称。 ". 字符串 searchPattern “s*”搜索以字母“s”开头的所有名称 path 。

EnumerateFiles和 GetFiles 方法的不同之处如下：

使用 EnumerateFiles时，可以在返回整个集合 FileInfo 之前开始枚举对象的集合。
使用 GetFiles时，必须等待整个对象数组 FileInfo 返回，然后才能访问数组。

因此，在使用许多文件和目录时， EnumerateFiles 可以更高效。

此方法预填充以下 FileInfo 属性的值：

未缓存返回的集合;每次对集合上的方法的调用 GetEnumerator 都将启动一个新的枚举。

适用于

EnumerateFiles(String, EnumerationOptions)

Source:: DirectoryInfo.cs

Source:: DirectoryInfo.cs

Source:: DirectoryInfo.cs

返回与指定的搜索模式和枚举选项匹配的文件信息的可枚举集合。

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)

参数

searchPattern: String

要与文件名匹配的搜索字符串。此参数可以包含有效文本路径和通配符（* 和 ?）的组合，但不支持正则表达式。

enumerationOptions: EnumerationOptions

描述要使用的搜索和枚举配置的对象。

IEnumerable<FileInfo>

与 searchPattern 和 enumerationOptions 匹配的文件的可枚举集合。

例外

ArgumentNullException

searchPattern 为 null。

DirectoryNotFoundException

封装在 DirectoryInfo 对象中的路径无效（例如，它位于未映射的驱动器上）。

SecurityException

调用方没有所要求的权限。

注解

searchPattern 可以是文本和通配符的组合，但它不支持正则表达式。允许在中 searchPattern使用以下通配符说明符。

通配符说明符	匹配
*（星号）	该位置的零个或多个字符。
? （问号）	该位置的零个字符或一个字符。

EnumerateFiles和 GetFiles 方法的不同之处如下：

使用 EnumerateFiles时，可以在返回整个集合 FileInfo 之前开始枚举对象的集合。
使用 GetFiles时，必须等待整个对象数组 FileInfo 返回，然后才能访问数组。

因此，在使用许多文件和目录时， EnumerateFiles 可以更高效。

此方法预填充以下 FileInfo 属性的值：

未缓存返回的集合;每次对集合上的方法的调用 GetEnumerator 都将启动一个新的枚举。

适用于

EnumerateFiles(String, SearchOption)

Source:: DirectoryInfo.cs

Source:: DirectoryInfo.cs

Source:: DirectoryInfo.cs

返回与指定的搜索模式和搜索子目录选项匹配的文件信息的可枚举集合。

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)

参数

searchPattern: String

要与文件名匹配的搜索字符串。此参数可以包含有效文本路径和通配符（* 和 ?）的组合，但不支持正则表达式。

searchOption: SearchOption

用于指定搜索操作是应仅包含当前目录还是应包含所有子目录的枚举值之一。默认值是 TopDirectoryOnly。

IEnumerable<FileInfo>

与 searchPattern 和 searchOption 匹配的文件的可枚举集合。

例外

ArgumentNullException

searchPattern 为 null。

ArgumentOutOfRangeException

searchOption 不是有效的 SearchOption 值。

DirectoryNotFoundException

封装在 DirectoryInfo 对象中的路径无效（例如，它位于未映射的驱动器上）。

SecurityException

调用方没有所要求的权限。

示例

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

注解

searchPattern 可以是文本和通配符的组合，但它不支持正则表达式。允许在中 searchPattern使用以下通配符说明符。

通配符说明符	匹配
*（星号）	该位置的零个或多个字符。
? （问号）	该位置的零个字符或一个字符。

EnumerateFiles和 GetFiles 方法的不同之处如下：

使用 EnumerateFiles时，可以在返回整个集合 FileInfo 之前开始枚举对象的集合。
使用 GetFiles时，必须等待整个对象数组 FileInfo 返回，然后才能访问数组。

因此，在使用许多文件和目录时， EnumerateFiles 可以更高效。

此方法预填充以下 FileInfo 属性的值：

未缓存返回的集合;每次对集合上的方法的调用 GetEnumerator 都将启动一个新的枚举。

适用于

通过

DirectoryInfo.EnumerateFiles 方法

定义

重载

EnumerateFiles()

返回

例外

示例

注解

适用于

EnumerateFiles(String)

参数

返回

例外

示例

注解

适用于

EnumerateFiles(String, EnumerationOptions)

参数

返回

例外

注解

适用于

EnumerateFiles(String, SearchOption)

参数

返回

例外

示例

注解

适用于

其他资源