FileSystem.GetFiles 方法

定义

命名空间:

Microsoft.VisualBasic.FileIO

程序集:

Microsoft.VisualBasic.Core.dll

返回字符串的只读集合，这些字符串表示目录内文件的名称。

重载

GetFiles(String)	返回字符串的只读集合，这些字符串表示目录内文件的名称。
GetFiles(String, SearchOption, String[])	返回字符串的只读集合，这些字符串表示目录内文件的名称。

GetFiles(String)

Source:

FileSystem.vb

返回字符串的只读集合，这些字符串表示目录内文件的名称。

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory);

static member GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function GetFiles (directory As String) As ReadOnlyCollection(Of String)

参数

directory

String

要搜索的目录。

返回

ReadOnlyCollection<String>

指定目录中的文件名的只读集合。

例外

ArgumentException

路径无效，原因如下：它是零长度字符串;它仅包含空格;它包含无效字符;或它是以 \\.\) 开头 (设备路径。

ArgumentNullException

directory 为 Nothing。

DirectoryNotFoundException

要搜索的目录不存在。

IOException

directory 指向某个现有文件。

PathTooLongException

路径超过了系统定义的最大长度。

NotSupportedException

路径中的文件名或目录名包含冒号 (:)，或格式无效。

SecurityException

该用户缺少查看该路径所必需的权限。

UnauthorizedAccessException

该用户缺少必要的权限。

示例

下面的示例返回目录中的所有文件，并将它们添加到 ListBox1。

For Each foundFile In My.Computer.FileSystem.GetFiles(
        My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    ListBox1.Items.Add(foundFile)
Next

此示例要求窗体上具有一个 ListBox 名为 ListBox1 的 。

此示例返回目录中扩展名为 的所有文件， .txt 并将其添加到 ListBox1。

For Each foundFile As String In My.Computer.FileSystem.GetFiles(
         My.Computer.FileSystem.SpecialDirectories.MyDocuments,
         FileIO.SearchOption.SearchTopLevelOnly, "*.txt")
    ListBox1.Items.Add(foundFile)
Next

此示例要求窗体上具有一个 ListBox 名为 ListBox1 的 。

注解

如果没有找到与指定模式匹配的文件，则返回一个空集合。

下表列出了涉及 My.Computer.FileSystem.GetFiles 方法的任务示例。

功能	查看
获取目录中的文件集合	如何：在 Visual Basic 中获取目录中的文件集合
在目录中查找具有特定模式的文件	如何：在 Visual Basic 中查找具有特定模式的文件

另请参阅

• ReadOnlyCollection<T>

GetFiles(String, SearchOption, String[])

Source:

FileSystem.vb

返回字符串的只读集合，这些字符串表示目录内文件的名称。

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);

static member GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function GetFiles (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)

参数

directory

String

要搜索的目录。

searchType

SearchOption

是否包含子文件夹。 默认值为 SearchOption.SearchTopLevelOnly。

wildcards

String[]

要匹配的模式。

返回

ReadOnlyCollection<String>

指定目录中的文件名的只读集合。

例外

ArgumentException

路径无效，原因如下：它是零长度字符串;它仅包含空格;它包含无效字符;或它是以 \\.\) 开头 (设备路径。

ArgumentNullException

directory 为 Nothing。

DirectoryNotFoundException

要搜索的目录不存在。

IOException

directory 指向某个现有文件。

PathTooLongException

路径超过了系统定义的最大长度。

NotSupportedException

路径中的文件名或目录名包含冒号 (:)，或格式无效。

SecurityException

该用户缺少查看该路径所必需的权限。

UnauthorizedAccessException

该用户缺少必要的权限。

示例

下面的示例返回目录中的所有文件，并将它们添加到 ListBox1。

For Each foundFile In My.Computer.FileSystem.GetFiles(
        My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    ListBox1.Items.Add(foundFile)
Next

此示例要求窗体上具有一个 ListBox 名为 ListBox1 的 。

此示例返回目录中扩展名为 的所有文件， .txt 并将其添加到 ListBox1。

For Each foundFile As String In My.Computer.FileSystem.GetFiles(
         My.Computer.FileSystem.SpecialDirectories.MyDocuments,
         FileIO.SearchOption.SearchTopLevelOnly, "*.txt")
    ListBox1.Items.Add(foundFile)
Next

此示例要求窗体上具有一个 ListBox 名为 ListBox1 的 。

注解

如果没有找到与指定模式匹配的文件，则返回一个空集合。

下表列出了涉及 My.Computer.FileSystem.GetFiles 方法的任务示例。

功能	查看
获取目录中的文件集合	如何：在 Visual Basic 中获取目录中的文件集合
在目录中查找具有特定模式的文件	如何：在 Visual Basic 中查找具有特定模式的文件

另请参阅

• SearchOption
• ReadOnlyCollection<T>