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 方法的任务的示例。
要执行的操作 |
请参见 |
---|---|
列出具有特定模式的子目录 |
示例
下面的示例将返回名称中包含单词 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 服务 |
是 |
网站 |
是 |
权限
以下权限可能是必需的:
权限 |
说明 |
---|---|
控制访问文件和文件夹的能力。关联的枚举:Unrestricted。 |