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

Статья
08/11/2011

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

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

Примечание

Сведения о том, как вернуть список файлов с помощью класса DirectoryInfo пространства имен System.IO см. в разделах GetFiles(String, SearchOption) и Практическое руководство. Создание списка каталогов.

Поиск файлов по указанному шаблону

Используйте метод GetFiles, указывая имя и путь каталога, в котором требуется выполнить поиск, и шаблон. Следующий пример возвращает все файлы с расширением .dll, имеющиеся в каталоге, и добавляет их в список ListBox1.
```
For Each foundFile As String In My.Computer.FileSystem.GetFiles(
    My.Computer.FileSystem.SpecialDirectories.MyDocuments,
    Microsoft.VisualBasic.FileIO.SearchOption.SearchAllSubDirectories, "*.dll")

    Listbox1.Items.Add(foundFile)
Next
```

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

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

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