FileSystem.GetDirectories Метод

Определение

Пространство имен:

Microsoft.VisualBasic.FileIO

Сборка:

Microsoft.VisualBasic.Core.dll

Возвращает коллекцию строк, представляющих имена путей подкаталогов в каталоге.

Перегрузки

Имя	Описание
GetDirectories(String)	Возвращает коллекцию строк, представляющих имена путей подкаталогов в каталоге.
GetDirectories(String, SearchOption, String[])	Возвращает коллекцию строк, представляющих имена путей подкаталогов в каталоге.

GetDirectories(String)

Исходный код:

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

В этом примере требуется, чтобы у вас был ListBox именованный ListBox1 в форме.

Комментарии

В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.GetDirectories метод.

Кому	Смотри
Вывод списка подкаталогов с определенным шаблоном	How to: Find Subdirectory with a Specific Pattern in Visual Basic

См. также раздел

• SearchOption
• ReadOnlyCollection<T>

GetDirectories(String, SearchOption, String[])

Исходный код:

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

В этом примере требуется, чтобы у вас был ListBox именованный ListBox1 в форме.

Комментарии

Параметр можно использовать wildcards для указания определенного шаблона. Если вы хотите включить содержимое подкаталогов в поиск, задайте для searchType параметра значение SearchAllSubDirectories.

Пустая коллекция возвращается, если каталоги, соответствующие указанному шаблону, не найдены.

В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.GetDirectories метод.

Кому	Смотри
Вывод списка подкаталогов с определенным шаблоном	How to: Find Subdirectory with a Specific Pattern in Visual Basic

См. также раздел

• SearchOption
• ReadOnlyCollection<T>