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

更新：2007 年 11 月

My.Computer.FileSystem.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 代码段。在代码段选择器中，它位于“文件系统 -- 处理驱动器、文件夹和文件”。有关更多信息，请参见如何：在代码中插入代码段 (Visual Basic)。

可靠编程

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

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

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

• directory 不存在 (DirectoryNotFoundException)。

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

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

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

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

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

请参见

任务

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

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

参考

My.Computer.FileSystem.GetFiles 方法