Прочитать на английском

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


FileSystem.GetFiles Метод

Определение

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

Перегрузки

GetFiles(String)

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

GetFiles(String, SearchOption, String[])

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

GetFiles(String)

Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb

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

public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory);

Параметры

directory
String

Каталог, в котором необходимо выполнить поиск.

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

Доступная только для чтения коллекция имен файлов из указанного каталога.

Исключения

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

directory имеет значение Nothing.

Каталог, где следует выполнить поиск, не существует.

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

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

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

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

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

Примеры

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

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

В этом примере требуется, чтобы в форме был ListBox с именем ListBox1 .

Этот пример возвращает все файлы в каталоге с расширением .txt и добавляет их в 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 .

Комментарии

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

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

См. также раздел

Применяется к

Продукт Версии

GetFiles(String, SearchOption, String[])

Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb

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

public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);

Параметры

directory
String

Каталог, в котором необходимо выполнить поиск.

searchType
SearchOption

Указывает, нужно ли включать вложенные папки. Значение по умолчанию — SearchOption.SearchTopLevelOnly.

wildcards
String[]

Шаблон, которому необходимо соответствовать.

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

Доступная только для чтения коллекция имен файлов из указанного каталога.

Исключения

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

directory имеет значение Nothing.

Каталог, где следует выполнить поиск, не существует.

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

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

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

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

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

Примеры

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

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

В этом примере требуется, чтобы в форме был ListBox с именем ListBox1 .

Этот пример возвращает все файлы в каталоге с расширением .txt и добавляет их в 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 .

Комментарии

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

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

См. также раздел

Применяется к

Продукт Версии