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

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

Возвращает коллекцию строк только для чтения, представляющих имена путей к файлам в папке.

' Usage
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetFiles(directory)
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetFiles(directory ,searchType ,wildcards)
' Declaration
Public Function GetFiles( _
   ByVal directory As String _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
' -or-
Public Function GetFiles( _
   ByVal directory As String, _
   ByVal searchType As SearchOption, _
   ByVal wildcards As String() _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)

Параметры

• directory
  String. Каталог, в котором необходимо выполнить поиск. Обязательно.

• searchType
  Перечисление SearchOption. Следует ли включать вложенные папки. По умолчанию используется значение SearchOption.SearchTopLevelOnly. Обязательно.

• wildcards
  String. Шаблон для сравнения. Обязательно.

Возвращаемое значение

Коллекция строк только для чтения.

Исключения

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

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

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

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

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

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

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

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

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

Заметки

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

Задачи

В приведенной ниже таблице показаны примеры задач, в которых используется метод My.Computer.FileSystem.GetFiles.

Пример

В следующем примере возвращаются все файлы в каталоге и добавляются в список ListBox1.

For Each foundFile As String In My.Computer.FileSystem.GetFiles _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    ListBox1.Items.Add(foundFile)
Next

В данном примере требуется наличие в форме объекта ListBox с именем ListBox1.

В этом примере возвращаются все файлы в каталоге с расширением .dll и добавляются к объекту ListBox1.

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

В данном примере требуется наличие в форме объекта ListBox с именем ListBox1.

Требования

Пространство имен:Microsoft.VisualBasic.MyServices

Класс:FileSystemProxy (предоставляет доступ к FileSystem)

Сборка: библиотека времени выполнения Visual Basic (в Microsoft.VisualBasic.dll)

Доступность по типу проекта

Разрешения

Могут потребоваться следующие разрешения:

Дополнительные сведения см. в разделах Управление доступом для кода и Запрос разрешений.

См. также

Задачи

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

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

Ссылки

Объект My.Computer.FileSystem

Перечисление SearchOption

System.Collections.ObjectModel.ReadOnlyCollection<T>

FileSystem.GetFiles