要查看英语原文,请勾选“英语”复选框。也可将鼠标指针移到文本上,在弹出窗口中显示英语原文。
翻译
英语
本文档已存档,并且将不进行维护。

Directory.EnumerateFileSystemEntries 方法 (String, String)

更新:2010 年 7 月

返回指定路径中与搜索模式匹配的文件系统项的可枚举集合。

命名空间:  System.IO
程序集:  mscorlib(在 mscorlib.dll 中)

public static IEnumerable<string> EnumerateFileSystemEntries(
	string path,
	string searchPattern
)

参数

path
类型:System.String
要搜索的目录。
searchPattern
类型:System.String
要与 path 中的目录名称匹配的搜索字符串。

返回值

类型:System.Collections.Generic.IEnumerable<String>
path 指定的目录中与 searchPattern 匹配的文件系统项的可枚举集合。

异常条件
ArgumentException

path 是零长度字符串、只包含空白或者包含在 GetInvalidPathChars 定义的无效字符。

- 或 -

searchPattern 不包含有效模式。

ArgumentNullException

pathnull

- 或 -

searchPatternnull

DirectoryNotFoundException

path 无效,比如引用未映射的驱动器。

IOException

path 是一个文件名。

PathTooLongException

指定的路径、文件名或者两者都超出了系统定义的最大长度。 例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260 个字符。

SecurityException

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

UnauthorizedAccessException

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

searchPattern 参数中允许使用以下通配说明符。

通配符

说明

*

零个或多个字符。

?

正好一个字符。

可以使用 path 参数指定相对路径信息。 相对路径信息被解释为相对于您可以使用 GetCurrentDirectory 方法来确定的当前工作目录。

EnumerateFileSystemEntries GetFileSystemEntries 方法不同点在于:当使用 EnumerateFileSystemEntries 时,您可以在返回整个集合之前开始枚举项的集合;当您使用 GetFileSystemEntries 时,则必须等待整个项的数组都被返回后才能访问数组。 因此,在处理许多文件和目录时,EnumerateFiles 可能更高效。

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

.NET Framework

受以下版本支持:4

.NET Framework Client Profile

受以下版本支持:4

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2

.NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求

Date

修订记录

原因

2010 年 7 月

更新了有关无缓存的备注。

信息补充。

显示: