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

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)。

另请参阅

• GetFiles
• 如何：查找具有特定模式的文件
• 如何：查找具有特定模式的子目录