My.Computer.FileSystem.GetDirectories 方法

更新：2007 年 11 月

返回代表某个目录内子目录的路径名的字符串集合。

' Usage
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetDirectories(directory)
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetDirectories(directory ,searchType ,wildcards)
' Declaration
Public Function GetDirectories( _
   ByVal directory As String _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
' -or-
Public Function GetDirectories( _
   ByVal directory As String, _
   ByVal searchType As SearchOption, _
   ByVal wildcards As String() _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)

参数

• directory
  String。目录的名称和路径。必选。

• searchType
  SearchOption 枚举。是否包括子文件夹。默认值为 SearchOption.SearchTopLevelOnly。必选。

• wildcards
  String。用于匹配名称的模式。必选。

返回值

String 的只读集合。

异常

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

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

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

• 一个或多个指定的通配符是 Nothing、空字符串或仅包含空格 (ArgumentNullException)。

• directory 不存在 (DirectoryNotFoundException)。

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

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

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

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

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

备注

可使用 wildcards 参数来指定具体模式。如果想要在搜索中包括子目录的内容，请将 searchType 参数设置为 SearchAllSubDirectories。

如果未找到与指定模式匹配的目录，则返回一个空集合。

任务

下表列出了涉及 My.Computer.FileSystem.GetDirectories 方法的任务的示例。

要执行的操作	请参见
列出具有特定模式的子目录	如何：在 Visual Basic 中查找具有特定模式的子目录

示例

下面的示例将返回名称中包含单词 Logs 的目录结构中的所有目录，并将这些目录添加到 ListBox1。

For Each foundDirectory As String In _
My.Computer.FileSystem.GetDirectories _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments, _
True, "*Logs*")
    ListBox1.Items.Add(foundDirectory)
Next

此示例要求窗体上有一个名为 ListBox1 的 ListBox。

要求

命名空间：Microsoft.VisualBasic.MyServices

类：FileSystemProxy（提供对 FileSystem 的访问）

**程序集：**Visual Basic 运行库（位于 Microsoft.VisualBasic.dll 中）

按项目类型列出的可用性

项目类型	可用
Windows 应用程序	是
类库	是
控制台应用程序	是
Windows 控件库	是
Web 控件库	是
Windows 服务	是
网站	是

权限

以下权限可能是必需的：

权限	说明
FileIOPermission	控制访问文件和文件夹的能力。关联的枚举：Unrestricted。

有关更多信息，请参见代码访问安全性和请求权限。

请参见

参考

My.Computer.FileSystem 对象

SearchOption 枚举

System.Collections.ObjectModel.ReadOnlyCollection<T>

FileSystem.GetDirectories