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

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

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

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

Чтобы найти файлы по указанному шаблону

  • Используйте метод GetFiles, указывая имя и путь каталога, в котором требуется выполнить поиск, и шаблон. Следующий пример возвращает все файлы с расширением .dll, имеющиеся в каталоге, и добавляет их в список ListBox1.

    For Each foundFile As String In My.Computer.FileSystem.GetFiles( _
        My.Computer.FileSystem.SpecialDirectories.MyDocuments, _
        FileIO.SearchOption.SearchAllSubDirectories, "*.dll")
    
        Listbox1.Items.Add(foundFile)
    Next
    

Безопасность

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

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

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

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

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

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

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

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

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

См. также

Задачи

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

Исправление неполадок, связанных с чтением из текстовых файлов и записью в такие файлы

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

Ссылки

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