FileSystem.GetFiles Метод

Определение

Пространство имен:

Microsoft.VisualBasic.FileIO

Сборка:

Microsoft.VisualBasic.Core.dll

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

Перегрузки

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

GetFiles(String)

Исходный код:

FileSystem.vb

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

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);

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

static member GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function GetFiles (directory As String) As ReadOnlyCollection(Of String)

Параметры

directory

String

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

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

ReadOnlyCollection<String>

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

Исключения

ArgumentException

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

ArgumentNullException

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

DirectoryNotFoundException

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

IOException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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

Примеры

В следующем примере возвращаются и добавляются в список 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 .

Кому	См.
Получение коллекции файлов в каталоге	Практическое руководство. Получение коллекции содержащихся в каталоге файлов в Visual Basic
Поиск файлов с определенным шаблоном в каталоге	Практическое руководство. Поиск файлов по конкретному шаблону в Visual Basic

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

• ReadOnlyCollection<T>

GetFiles(String, SearchOption, String[])

Исходный код:

FileSystem.vb

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

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);

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

static member GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function GetFiles (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)

Параметры

directory

String

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

searchType

SearchOption

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

wildcards

String[]

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

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

ReadOnlyCollection<String>

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

Исключения

ArgumentException

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

ArgumentNullException

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

DirectoryNotFoundException

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

IOException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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

Примеры

В следующем примере возвращаются и добавляются в список 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 .

Кому	См.
Получение коллекции файлов в каталоге	Практическое руководство. Получение коллекции содержащихся в каталоге файлов в Visual Basic
Поиск файлов с определенным шаблоном в каталоге	Практическое руководство. Поиск файлов по конкретному шаблону в Visual Basic

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

• SearchOption
• ReadOnlyCollection<T>