Поделиться через


FileSystemProxy.GetDirectories Метод

Определение

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

Перегрузки

GetDirectories(String)

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

GetDirectories(String, SearchOption, String[])

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

GetDirectories(String)

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

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetDirectories(System::String ^ directory);
public System.Collections.ObjectModel.ReadOnlyCollection<string> GetDirectories (string directory);
member this.GetDirectories : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Function GetDirectories (directory As String) As ReadOnlyCollection(Of String)

Параметры

directory
String

Путь к каталогу и его имя.

Возвращаемое значение

Доступная только для чтения коллекция путей к подкаталогам в указанном каталоге.

Исключения

Путь недопустим по одной из следующих причин: это строка нулевой длины; содержит только пробелы; содержит недопустимые символы; или это путь к устройству (начинается с \\.\).

Параметр directory имеет значение Nothing или является пустой строкой.

Заданный каталог не существует.

Заданный каталог указывает на существующий файл.

Длина пути превышает максимальную длину, определенную в системе.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.

У пользователя отсутствуют необходимые разрешения на просмотр пути.

У пользователя нет необходимых разрешений.

Примеры

Следующий пример возвращает все каталоги в структуре каталогов, содержащие слово 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 .

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

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

Применяется к

GetDirectories(String, SearchOption, String[])

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

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetDirectories(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);
public System.Collections.ObjectModel.ReadOnlyCollection<string> GetDirectories (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);
member this.GetDirectories : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Function GetDirectories (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)

Параметры

directory
String

Путь к каталогу и его имя.

searchType
SearchOption

Указывает, нужно ли включать вложенные папки. Значение по умолчанию — SearchOption.SearchTopLevelOnly.

wildcards
String[]

Шаблон, которому должны соответствовать имена.

Возвращаемое значение

Доступная только для чтения коллекция путей к подкаталогам в указанном каталоге.

Исключения

Путь недопустим по одной из следующих причин: это строка нулевой длины; содержит только пробелы; содержит недопустимые символы; или это путь к устройству (начинается с \\.\).

Один или несколько указанных подстановочных знаков являются Nothing, пустой строкой или содержат только пробелы.

Заданный каталог не существует.

Заданный каталог указывает на существующий файл.

Длина пути превышает максимальную длину, определенную в системе.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.

У пользователя отсутствуют необходимые разрешения на просмотр пути.

У пользователя нет необходимых разрешений.

Примеры

Следующий пример возвращает все каталоги в структуре каталогов, содержащие слово 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 .

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

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

Применяется к