System.IO.DirectoryInfo.GetFileSystemInfos 方法 (String, SearchOption)

方法描述

检索表示与指定的搜索条件匹配的文件和子目录的 FileSystemInfo 对象的数组。

语法定义(C# System.IO.DirectoryInfo.GetFileSystemInfos 方法 (String, SearchOption) 的用法)

public FileSystemInfo[] GetFileSystemInfos(
	string searchPattern,
	SearchOption searchOption
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
searchPattern System-String 搜索字符串。默认模式为“*”,该模式返回所有文件和目录。
searchOption System-IO-SearchOption 用于指定搜索操作是应仅包含当前目录还是应包含所有子目录的枚举值之一。默认值为 TopDirectoryOnly。
返回值 System.IO.FileSystemInfo[] 一个数组,包含与搜索条件匹配的文件系统项。

提示和注释

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

通配符

说明

*

零个或多个字符。

?

正好一个字符。

对于子目录,此方法返回的 FileSystemInfo 对象可强制转换为派生类 DirectoryInfo。 使用 FileSystemInfo.Attributes 属性返回的 FileAttributes 值可确定 FileSystemInfo 表示的是文件还是目录。

此方法预填充下面的 FileSystemInfo 属性的值:

Attributes

CreationTime

CreationTimeUtc

LastAccessTime

LastAccessTimeUtc

LastWriteTime

LastWriteTimeUtc

System.IO.DirectoryInfo.GetFileSystemInfos 方法 (String, SearchOption)例子


异常

异常 异常描述
ArgumentException searchPattern 包含由 GetInvalidPathChars 方法定义的一个或多个无效字符。
ArgumentNullException searchPattern 为 null。
ArgumentOutOfRangeException searchOption 不是有效的 SearchOption 值。
DirectoryNotFoundException 指定的路径无效(例如,它位于未映射的驱动器上)。
SecurityException 调用方没有所要求的权限。

命名空间

namespace: System.IO

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.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 系统要求。