FileSystem.GetDirectories 方法

定义

命名空间:

Microsoft.VisualBasic.FileIO

程序集:

Microsoft.VisualBasic.Core.dll

返回一个字符串集合，这些字符串表示目录内子目录的路径名。

重载

GetDirectories(String)	返回一个字符串集合，这些字符串表示目录内子目录的路径名。
GetDirectories(String, SearchOption, String[])	返回一个字符串集合，这些字符串表示目录内子目录的路径名。

GetDirectories(String)

Source:

FileSystem.vb

返回一个字符串集合，这些字符串表示目录内子目录的路径名。

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetDirectories(System::String ^ directory);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetDirectories (string directory);

static member GetDirectories : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function GetDirectories (directory As String) As ReadOnlyCollection(Of String)

参数

directory

String

目录的名称和路径。

返回

ReadOnlyCollection<String>

所指定目录中，子目录路径名称的只读集合。

例外

ArgumentException

由于以下原因之一，路径无效：它是一个长度为零的字符串;它只包含空格;它包含无效字符;或它是以 \\.\) 开头的设备路径 (。

ArgumentNullException

directory 为 Nothing 或空字符串。

DirectoryNotFoundException

指定的目录不存在。

IOException

指定的目录指向某个现有文件。

PathTooLongException

路径超过了系统定义的最大长度。

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

该用户缺少必要的权限。

示例

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

For Each foundDirectory In My.Computer.FileSystem.GetDirectories(
      My.Computer.FileSystem.SpecialDirectories.MyDocuments,
      True, "*Logs*")

    ListBox1.Items.Add(foundDirectory)
Next

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

注解

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

功能	查看
列出具有特定模式的子目录	如何：在 Visual Basic 中查找具有特定模式的子目录

另请参阅

• SearchOption
• ReadOnlyCollection<T>

GetDirectories(String, SearchOption, String[])

Source:

FileSystem.vb

返回一个字符串集合，这些字符串表示目录内子目录的路径名。

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetDirectories(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetDirectories (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);

static member GetDirectories : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function GetDirectories (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)

参数

directory

String

目录的名称和路径。

searchType

SearchOption

是否包含子文件夹。 默认值为 SearchOption.SearchTopLevelOnly。

wildcards

String[]

用于匹配名称的模式。

返回

ReadOnlyCollection<String>

所指定目录中，子目录路径名称的只读集合。

例外

ArgumentException

由于以下原因之一，路径无效：它是一个长度为零的字符串;它只包含空格;它包含无效字符;或它是以 \\.\) 开头的设备路径 (。

ArgumentNullException

一个或多个指定的通配符为 Nothing、空字符串，或者仅包含空格。

DirectoryNotFoundException

指定的目录不存在。

IOException

指定的目录指向某个现有文件。

PathTooLongException

路径超过了系统定义的最大长度。

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

该用户缺少必要的权限。

示例

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

For Each foundDirectory In My.Computer.FileSystem.GetDirectories(
      My.Computer.FileSystem.SpecialDirectories.MyDocuments,
      True, "*Logs*")

    ListBox1.Items.Add(foundDirectory)
Next

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

注解

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

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

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

功能	查看
列出具有特定模式的子目录	如何：在 Visual Basic 中查找具有特定模式的子目录

另请参阅

• SearchOption
• ReadOnlyCollection<T>