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


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

Метод 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. В окне выбора фрагмента кода он находится в разделе Файловая система — Обработка дисков, папок и файлов. Дополнительные сведения см. в разделе Практическое руководство. Вставка фрагментов кода IntelliSense.

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

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

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

  • Путь не является допустимым, поскольку он равен Nothing (ArgumentNullException).

  • Параметр directory не существует (DirectoryNotFoundException).

  • Параметр directory указывает на существующий файл (IOException).

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

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

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

  • Пользователь не имеет необходимых разрешений (UnauthorizedAccessException).

См. также

Задачи

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

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

Ссылки

GetFiles