DirectoryInfo.GetFileSystemInfos 方法

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

检索表示当前目录的文件和子目录的强类型 FileSystemInfo 对象的数组。

重载

GetFileSystemInfos()	返回表示某个目录中所有文件和子目录的强类型 FileSystemInfo 项的数组。
GetFileSystemInfos(String)	检索表示与指定的搜索条件匹配的文件和子目录的强类型 FileSystemInfo 对象的数组。
GetFileSystemInfos(String, EnumerationOptions)	检索强类型 FileSystemInfo 对象的数组，这些对象表示与指定的搜索模式和枚举选项匹配的文件和子目录。
GetFileSystemInfos(String, SearchOption)	检索表示与指定的搜索条件匹配的文件和子目录的 FileSystemInfo 对象的数组。

GetFileSystemInfos()

Source:

DirectoryInfo.cs

返回表示某个目录中所有文件和子目录的强类型 FileSystemInfo 项的数组。

public:
 cli::array <System::IO::FileSystemInfo ^> ^ GetFileSystemInfos();

public System.IO.FileSystemInfo[] GetFileSystemInfos ();

member this.GetFileSystemInfos : unit -> System.IO.FileSystemInfo[]

Public Function GetFileSystemInfos () As FileSystemInfo()

返回

FileSystemInfo[]

强类型 FileSystemInfo 项的数组。

例外

DirectoryNotFoundException

路径无效（例如，它位于未映射的驱动器上）。

示例

以下示例对指定目录下的文件和目录进行计数。

using System;
using System.IO;

class DirectoryFileCount
{

    static long files = 0;
    static long directories = 0;

    static void Main()
    {
        try
        {
            Console.WriteLine("Enter the path to a directory:");

            string directory = Console.ReadLine();

            // Create a new DirectoryInfo object.
            DirectoryInfo dir = new DirectoryInfo(directory);

            if (!dir.Exists)
            {
                throw new DirectoryNotFoundException("The directory does not exist.");
            }

            // Call the GetFileSystemInfos method.
            FileSystemInfo[] infos = dir.GetFileSystemInfos();

            Console.WriteLine("Working...");

            // Pass the result to the ListDirectoriesAndFiles
            // method defined below.
            ListDirectoriesAndFiles(infos);

            // Display the results to the console.
            Console.WriteLine("Directories: {0}", directories);
            Console.WriteLine("Files: {0}", files);
        }
        catch (Exception e)
        {
            Console.WriteLine(e.Message);
        }
        finally
        {

            Console.ReadLine();
        }
    }

    static void ListDirectoriesAndFiles(FileSystemInfo[] FSInfo)
    {
        // Check the FSInfo parameter.
        if (FSInfo == null)
        {
            throw new ArgumentNullException("FSInfo");
        }

        // Iterate through each item.
        foreach (FileSystemInfo i in FSInfo)
        {
            // Check to see if this is a DirectoryInfo object.
            if (i is DirectoryInfo)
            {
                // Add one to the directory count.
                directories++;

                // Cast the object to a DirectoryInfo object.
                DirectoryInfo dInfo = (DirectoryInfo)i;

                // Iterate through all sub-directories.
                ListDirectoriesAndFiles(dInfo.GetFileSystemInfos());
            }
            // Check to see if this is a FileInfo object.
            else if (i is FileInfo)
            {
                // Add one to the file count.
                files++;
            }
        }
    }
}

open System.IO

let mutable files = 0
let mutable directories = 0

let rec listDirectoriesAndFiles (fsInfo: FileSystemInfo[]) =
    // Check the FSInfo parameter.
    if fsInfo = null then
        nullArg "fsInfo"

    // Iterate through each item.
    for i in fsInfo do
        // Check to see if this is a DirectoryInfo object.
        match i with 
        | :? DirectoryInfo as dInfo ->
            // Add one to the directory count.
            directories <- directories + 1

            // Iterate through all sub-directories.
            listDirectoriesAndFiles (dInfo.GetFileSystemInfos())
        // Check to see if this is a FileInfo object.
        | :? FileInfo ->
            // Add one to the file count.
            files <- files + 1
        | _ -> ()

try
    printfn "Enter the path to a directory:"

    let directory = stdin.ReadLine()

    // Create a new DirectoryInfo object.
    let dir = DirectoryInfo directory

    if not dir.Exists then
        raise (DirectoryNotFoundException "The directory does not exist.")

    // Call the GetFileSystemInfos method.
    let infos = dir.GetFileSystemInfos()

    printfn "Working..."

    // Pass the result to the ListDirectoriesAndFiles
    // method defined below.
    listDirectoriesAndFiles infos

    // Display the results to the console.
    printfn $"Directories: {directories}"
    printfn $"Files: {files}"
with e ->
    printfn $"{e.Message}"

Imports System.IO



Module DirectoryFileCount

    Dim files As Long = 0
    Dim directories As Long = 0



    Sub Main()
        Try
            Console.WriteLine("Enter the path to a directory:")

            Dim directory As String = Console.ReadLine()

            ' Create a new DirectoryInfo object.
            Dim dir As New DirectoryInfo(directory)

            If Not dir.Exists Then
                Throw New DirectoryNotFoundException("The directory does not exist.")
            End If

            ' Call the GetFileSystemInfos method.
            Dim infos As FileSystemInfo() = dir.GetFileSystemInfos()

            Console.WriteLine("Working...")

            ' Pass the result to the ListDirectoriesAndFiles
            ' method defined below.
            ListDirectoriesAndFiles(infos)

            ' Display the results to the console. 
            Console.WriteLine("Directories: {0}", directories)
            Console.WriteLine("Files: {0}", files)

        Catch e As Exception
            Console.WriteLine(e.Message)
        Finally

            Console.ReadLine()
        End Try

    End Sub


    Sub ListDirectoriesAndFiles(ByVal FSInfo() As FileSystemInfo)
        ' Check the FSInfo parameter.
        If FSInfo Is Nothing Then
            Throw New ArgumentNullException("FSInfo")
        End If

        ' Iterate through each item.
        Dim i As FileSystemInfo
        For Each i In FSInfo
            ' Check to see if this is a DirectoryInfo object.
            If TypeOf i Is DirectoryInfo Then
                ' Add one to the directory count.
                directories += 1

                ' Cast the object to a DirectoryInfo object.
                Dim dInfo As DirectoryInfo = CType(i, DirectoryInfo)

                ' Iterate through all sub-directories.
                ListDirectoriesAndFiles(dInfo.GetFileSystemInfos())
                ' Check to see if this is a FileInfo object.
            ElseIf TypeOf i Is FileInfo Then
                ' Add one to the file count.
                files += 1
            End If
        Next i

    End Sub
End Module

注解

如果 中没有文件或目录， DirectoryInfo则此方法返回空数组。 此方法不是递归方法。

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

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

• Attributes

• CreationTime

• CreationTimeUtc

• LastAccessTime

• LastAccessTimeUtc

• LastWriteTime

• LastWriteTimeUtc

另请参阅

• FileSystemInfo
• FileSystemWatcher
• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件

GetFileSystemInfos(String)

Source:

DirectoryInfo.cs

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

public:
 cli::array <System::IO::FileSystemInfo ^> ^ GetFileSystemInfos(System::String ^ searchPattern);

public System.IO.FileSystemInfo[] GetFileSystemInfos (string searchPattern);

member this.GetFileSystemInfos : string -> System.IO.FileSystemInfo[]

Public Function GetFileSystemInfos (searchPattern As String) As FileSystemInfo()

参数

searchPattern

String

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

返回

FileSystemInfo[]

与搜索条件匹配的强类型 FileSystemInfo 对象的数组。

例外

ArgumentException

.NET Framework 和 2.1 之前的 .NET Core 版本：searchPattern包含 方法定义的GetInvalidPathChars()一个或多个无效字符。

ArgumentNullException

searchPattern 为 null。

DirectoryNotFoundException

指定的路径无效（例如，它位于未映射的驱动器上）。

SecurityException

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

示例

以下示例对与指定搜索模式匹配的文件和目录进行计数。

using System;
using System.IO;

class DirectoryFileCount
{

    static long files = 0;
    static long directories = 0;

    static void Main()
    {
        try
        {
            Console.WriteLine("Enter the path to a directory:");

            string directory = Console.ReadLine();

            Console.WriteLine("Enter a search string (for example *p*):");

            string searchString = Console.ReadLine();

            // Create a new DirectoryInfo object.
            DirectoryInfo dir = new DirectoryInfo(directory);

            if (!dir.Exists)
            {
                throw new DirectoryNotFoundException("The directory does not exist.");
            }

            // Call the GetFileSystemInfos method.
            FileSystemInfo[] infos = dir.GetFileSystemInfos(searchString);

            Console.WriteLine("Working...");

            // Pass the result to the ListDirectoriesAndFiles
            // method defined below.
            ListDirectoriesAndFiles(infos, searchString);

            // Display the results to the console.
            Console.WriteLine("Directories: {0}", directories);
            Console.WriteLine("Files: {0}", files);
        }
        catch (Exception e)
        {
            Console.WriteLine(e.Message);
        }
        finally
        {

            Console.ReadLine();
        }
    }

    static void ListDirectoriesAndFiles(FileSystemInfo[] FSInfo, string SearchString)
    {
        // Check the parameters.
        if (FSInfo == null)
        {
            throw new ArgumentNullException("FSInfo");
        }
        if (SearchString == null || SearchString.Length == 0)
        {
            throw new ArgumentNullException("SearchString");
        }

        // Iterate through each item.
        foreach (FileSystemInfo i in FSInfo)
        {
            // Check to see if this is a DirectoryInfo object.
            if (i is DirectoryInfo)
            {
                // Add one to the directory count.
                directories++;

                // Cast the object to a DirectoryInfo object.
                DirectoryInfo dInfo = (DirectoryInfo)i;

                // Iterate through all sub-directories.
                ListDirectoriesAndFiles(dInfo.GetFileSystemInfos(SearchString), SearchString);
            }
            // Check to see if this is a FileInfo object.
            else if (i is FileInfo)
            {
                // Add one to the file count.
                files++;
            }
        }
    }
}

open System
open System.IO

let mutable files = 0
let mutable directories = 0

let rec listDirectoriesAndFiles (fsInfo: FileSystemInfo[]) searchString =
    // Check the parameters.
    if fsInfo = null then
        nullArg "fsInfo"

    if String.IsNullOrEmpty searchString then
        invalidArg "searchString" "Search string cannot be empty."
    
    // Iterate through each item.
    for i in fsInfo do
        // Check to see if this is a DirectoryInfo object.
        match i with
        | :? DirectoryInfo as dInfo ->
            // Add one to the directory count.
            directories <- directories + 1

            // Iterate through all sub-directories.
            listDirectoriesAndFiles (dInfo.GetFileSystemInfos searchString) searchString
        // Check to see if this is a FileInfo object.
        | :? FileInfo ->
            // Add one to the file count.
            files <- files + 1
        | _ -> ()

try
    printfn "Enter the path to a directory:"

    let directory = stdin.ReadLine()

    printfn "Enter a search string (for example *p*):"

    let searchString = stdin.ReadLine()

    // Create a new DirectoryInfo object.
    let dir = DirectoryInfo directory

    if not dir.Exists then
        raise (DirectoryNotFoundException "The directory does not exist.")

    // Call the GetFileSystemInfos method.
    let infos = dir.GetFileSystemInfos searchString

    printfn "Working..."

    // Pass the result to the ListDirectoriesAndFiles
    // method defined below.
    listDirectoriesAndFiles infos searchString

    // Display the results to the console.
    printfn $"Directories: {directories}"
    printfn $"Files: {files}"
with e ->
    printfn $"{e.Message}"

Imports System.IO



Module DirectoryFileCount

    Dim files As Long = 0
    Dim directories As Long = 0



    Sub Main()
        Try
            Console.WriteLine("Enter the path to a directory:")

            Dim directory As String = Console.ReadLine()

            Console.WriteLine("Enter a search string (for example *p*):")

            Dim searchString As String = Console.ReadLine()

            ' Create a new DirectoryInfo object.
            Dim dir As New DirectoryInfo(directory)

            If Not dir.Exists Then
                Throw New DirectoryNotFoundException("The directory does not exist.")
            End If

            ' Call the GetFileSystemInfos method.
            Dim infos As FileSystemInfo() = dir.GetFileSystemInfos(searchString)

            Console.WriteLine("Working...")

            ' Pass the result to the ListDirectoriesAndFiles
            ' method defined below.
            ListDirectoriesAndFiles(infos, searchString)

            ' Display the results to the console. 
            Console.WriteLine("Directories: {0}", directories)
            Console.WriteLine("Files: {0}", files)

        Catch e As Exception
            Console.WriteLine(e.Message)
        Finally

            Console.ReadLine()
        End Try

    End Sub


    Sub ListDirectoriesAndFiles(ByVal FSInfo() As FileSystemInfo, ByVal SearchString As String)
        ' Check the parameters.
        If FSInfo Is Nothing Then
            Throw New ArgumentNullException("FSInfo")
        End If
        If SearchString Is Nothing OrElse SearchString.Length = 0 Then
            Throw New ArgumentNullException("SearchString")
        End If

        ' Iterate through each item.
        Dim i As FileSystemInfo
        For Each i In FSInfo
            ' Check to see if this is a DirectoryInfo object.
            If TypeOf i Is DirectoryInfo Then
                ' Add one to the directory count.
                directories += 1

                ' Cast the object to a DirectoryInfo object.
                Dim dInfo As DirectoryInfo = CType(i, DirectoryInfo)

                ' Iterate through all sub-directories.
                ListDirectoriesAndFiles(dInfo.GetFileSystemInfos(SearchString), SearchString)
                ' Check to see if this is a FileInfo object.
            ElseIf TypeOf i Is FileInfo Then
                ' Add one to the file count.
                files += 1
            End If
        Next i

    End Sub
End Module

注解

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

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

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

此方法不是递归方法。

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

允许使用通配符。 例如， searchPattern 字符串“*t”搜索以字母“t”结尾的所有目录名称 path 。 字符串 searchPattern “s*”搜索以字母“s”开头的所有目录名称 path 。

只有在将字符串“..”指定为有效目录名称的一部分（例如在目录名称“a.”中）时，才能在 searchPattern 中使用。b". 它不能用于向上移动目录层次结构。 如果没有文件或目录，或者没有与 中的DirectoryInfo字符串匹配searchPattern的文件或目录，则此方法返回空数组。

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

• Attributes

• CreationTime

• CreationTimeUtc

• LastAccessTime

• LastAccessTimeUtc

• LastWriteTime

• LastWriteTimeUtc

另请参阅

• FileSystemInfo
• FileSystemWatcher
• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件

GetFileSystemInfos(String, EnumerationOptions)

Source:

DirectoryInfo.cs

检索强类型 FileSystemInfo 对象的数组，这些对象表示与指定的搜索模式和枚举选项匹配的文件和子目录。

public:
 cli::array <System::IO::FileSystemInfo ^> ^ GetFileSystemInfos(System::String ^ searchPattern, System::IO::EnumerationOptions ^ enumerationOptions);

public System.IO.FileSystemInfo[] GetFileSystemInfos (string searchPattern, System.IO.EnumerationOptions enumerationOptions);

member this.GetFileSystemInfos : string * System.IO.EnumerationOptions -> System.IO.FileSystemInfo[]

Public Function GetFileSystemInfos (searchPattern As String, enumerationOptions As EnumerationOptions) As FileSystemInfo()

参数

searchPattern

String

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

enumerationOptions

EnumerationOptions

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

返回

FileSystemInfo[]

与 searchPattern 和 enumerationOptions 匹配的强类型 FileSystemInfo 对象的数组。

例外

ArgumentException

.NET Framework 和 2.1 之前的 .NET Core 版本：searchPattern包含 方法定义的GetInvalidPathChars()一个或多个无效字符。

ArgumentNullException

searchPattern 为 null。

DirectoryNotFoundException

指定的路径无效（例如，它位于未映射的驱动器上）。

SecurityException

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

注解

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

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

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

此方法不是递归方法。

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

允许使用通配符。 例如， searchPattern 字符串“*t”搜索以字母“t”结尾的所有目录名称 path 。 字符串 searchPattern “s*”搜索以字母“s”开头的所有目录名称 path 。

只有在将字符串“..”指定为有效目录名称的一部分（例如在目录名称“a.”中）时，才能在 searchPattern 中使用。b". 它不能用于向上移动目录层次结构。 如果没有文件或目录，或者没有与 中的DirectoryInfo字符串匹配searchPattern的文件或目录，则此方法返回空数组。

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

• Attributes

• CreationTime

• CreationTimeUtc

• LastAccessTime

• LastAccessTimeUtc

• LastWriteTime

• LastWriteTimeUtc

GetFileSystemInfos(String, SearchOption)

Source:

DirectoryInfo.cs

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

public:
 cli::array <System::IO::FileSystemInfo ^> ^ GetFileSystemInfos(System::String ^ searchPattern, System::IO::SearchOption searchOption);

public System.IO.FileSystemInfo[] GetFileSystemInfos (string searchPattern, System.IO.SearchOption searchOption);

member this.GetFileSystemInfos : string * System.IO.SearchOption -> System.IO.FileSystemInfo[]

Public Function GetFileSystemInfos (searchPattern As String, searchOption As SearchOption) As FileSystemInfo()

参数

searchPattern

String

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

searchOption

SearchOption

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

返回

FileSystemInfo[]

与搜索条件匹配的文件系统项的数组。

例外

ArgumentException

.NET Framework 和 2.1 之前的 .NET Core 版本：searchPattern包含 方法定义的GetInvalidPathChars()一个或多个无效字符。

ArgumentNullException

searchPattern 为 null。

ArgumentOutOfRangeException

searchOption 不是有效的 SearchOption 值。

DirectoryNotFoundException

指定的路径无效（例如，它位于未映射的驱动器上）。

SecurityException

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

注解

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

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

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

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

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

• Attributes

• CreationTime

• CreationTimeUtc

• LastAccessTime

• LastAccessTimeUtc

• LastWriteTime

• LastWriteTimeUtc

另请参阅

• FileSystemWatcher