Практическое руководство. Получение коллекции содержащихся в каталоге файлов в Visual Basic

Статья
11/05/2008

Обновлен: Ноябрь 2007

Метод My.Computer.FileSystem.GetFiles возвращает коллекцию строк только для чтения, представляющих имена файлов в каталоге. Для указания конкретного шаблона можно использовать параметр wildCards. Если требуется включить в поиск содержимое вложенных каталогов, следует присвоить параметру searchType значение SearchOption.SearchAllSubDirectories.

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

Чтобы получить список файлов в каталоге

Используйте метод GetFiles, указав имя и путь к каталогу, в котором требуется выполнить поиск. Следующий пример возвращает все файлы в каталоге и добавляет их в список ListBox1.
```
For Each foundFile As String In My.Computer.FileSystem.GetFiles _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    listBox1.Items.Add(foundFile)
Next
```
Данный пример также доступен в виде фрагмента кода IntelliSense. В окне выбора фрагмента кода он находится в разделе Файловая система — Обработка дисков, папок и файлов. Дополнительные сведения см. в разделе Практическое руководство. Вставка фрагментов в код (Visual Basic).

Отказоустойчивость

При следующих условиях может возникнуть исключение.

Путь является недопустимым по одной из следующих причин: это строка нулевой длины (пустая строка); она содержит только пробелы; она содержит недопустимые знаки; или это путь устройства (начинается с \\.\) (ArgumentException).
Путь не является допустимым, поскольку он равен Nothing (ArgumentNullException).
Параметр directory не существует (DirectoryNotFoundException).
Параметр directory указывает на существующий файл (IOException).
Длина пути превышает максимальную длину, определенную в системе (PathTooLongException).
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат (NotSupportedException).
У пользователя отсутствуют необходимые разрешения на просмотр пути (SecurityException).
Пользователь не имеет необходимых разрешений (UnauthorizedAccessException).

См. также

Задачи

Практическое руководство. Поиск файлов с конкретным шаблоном в Visual Basic

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

Ссылки

Метод My.Computer.FileSystem.GetFiles

Share via