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


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

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

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

Поиск подкаталогов по заданному шаблону

  • Используйте метод GetDirectories, указав имя и путь к каталогу для поиска.В следующем примере возвращаются и отображаются в элементе управления ListBox1 все каталоги в структуре каталогов, имена которых содержат слово "Logs".

    For Each foundDirectory As String In
           My.Computer.FileSystem.GetDirectories(
               My.Computer.FileSystem.SpecialDirectories.MyDocuments,
               FileIO.SearchOption.SearchTopLevelOnly,
               "*Logs*")
    
        ListBox1.Items.Add(foundDirectory)
    Next
    

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

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

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

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

  • Один или несколько указанных подстановочных знаков является Nothing, пустой строкой или содержит только пробелы (ArgumentNullException).

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

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

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

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

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

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

См. также

Задачи

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

Ссылки

GetDirectories