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