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 метод .

Кому	См.
Перечисление подкаталогов с определенным шаблоном	Практическое руководство. Поиск подкаталогов по шаблону в 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 метод .

Кому	См.
Перечисление подкаталогов с определенным шаблоном	Практическое руководство. Поиск подкаталогов по шаблону в Visual Basic

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

• SearchOption
• ReadOnlyCollection<T>