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

2025-06-19

该方法的重载返回一个只读字符串集合，表示目录中所有文件的名称:

将 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）。

另请参阅