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


Практическое руководство. Получение коллекции содержащихся в каталоге файлов в 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
    

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

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

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

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

  • directory не существует (DirectoryNotFoundException).

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

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

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

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

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

См. также

Задачи

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

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

Ссылки

GetFiles