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

GetFiles 方法返回字符串的只读集合，这些字符串表示目录内文件的名称。 可以使用 wildCards 参数来指定特定模式。 若要在搜索中包括子目录，请将 searchType 参数设置为 SearchOption.SearchAllSubDirectories。

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

列出目录中的文件

• 使用 GetFiles 方法，并提供要搜索的目录的名称和路径。 下面的示例返回目录中的所有文件，并将它们添加到 ListBox1。

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

  此代码示例也可用作 IntelliSense 代码段。 在代码段选择器中，它位于**“文件系统 -- 处理驱动器、文件夹和文件”**。 有关更多信息，请参见 如何：插入 IntelliSense 代码段。

可靠编程

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

• 路径无效，由于下列原因之一： 它是零长度字符串，它仅包含空白，它包含无效的字符，或它是一个设备路径 （以开始 \\。 \) (ArgumentException).

• 路径无效，因为它是 Nothing (ArgumentNullException)。

• directory 不存在 (DirectoryNotFoundException)。

• directory 指向某个现有文件 (IOException)。

• 路径超过了系统定义的最大长度 (PathTooLongException)。

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

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

• 该用户缺少必要的权限 (UnauthorizedAccessException)。

请参见

任务

如何：在 Visual Basic 中查找具有特定模式的文件

如何：在 Visual Basic 中查找具有特定模式的子目录

参考

GetFiles