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

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

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

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

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

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

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

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

Возникновение исключения возможно при следующих условиях:

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

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

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

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

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

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

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

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

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

См. также

Задачи

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

Ссылки

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