如何：在 Visual Basic 中获取目录中的文件集合

项目
04/07/2023

FileSystem.GetFiles 方法的重载返回字符串的只读集合，这些字符串表示目录内文件的名称：

将 GetFiles(String) 重载用于指定目录中的简单文件搜索，而无需搜索子目录。
使用 GetFiles(String, SearchOption, String[]) 重载指定搜索的其他选项。可以使用 wildCards 参数来指定搜索模式。若要在搜索中包括子目录，请将 searchType 参数设置为 SearchOption.SearchAllSubDirectories。

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

列出目录中的文件

使用其中一个 FileSystem.GetFiles 方法重载，向 directory 参数中的搜索提供目录的名称和路径。下面的示例返回目录中的所有文件，并将它们添加到 ListBox1。
```
For Each foundFile As String In My.Computer.FileSystem.GetFiles(
  My.Computer.FileSystem.SpecialDirectories.MyDocuments)

    listBox1.Items.Add(foundFile)
Next
```

可靠编程

以下情况可能会导致异常：

路径由于以下原因之一而无效：属于零长度字符串、仅包含空格、包含无效字符或属于设备路径（开头字符为 \\.\）(ArgumentException)。
路径无效，因为它是 Nothing (ArgumentNullException)。
directory 不存在 (DirectoryNotFoundException)。
directory 指向某个现有文件 (IOException)。
路径超过了系统定义的最大长度 (PathTooLongException)。
路径中的文件名或目录名包含冒号 (:)，或格式无效 (NotSupportedException)。
该用户缺少查看该路径所必需的权限 (SecurityException)。
该用户缺少必要的权限 (UnauthorizedAccessException)。

另请参阅