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 .

Кому	Смотри
Получение коллекции файлов в каталоге	How to: Get the Collection of Files in a Directory in a Directory in Visual Basic
Поиск файлов с определенным шаблоном в каталоге	How to: Find Files with a Specific Pattern in 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 .

Кому	Смотри
Получение коллекции файлов в каталоге	How to: Get the Collection of Files in a Directory in a Directory in Visual Basic
Поиск файлов с определенным шаблоном в каталоге	How to: Find Files with a Specific Pattern in Visual Basic

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

• SearchOption
• ReadOnlyCollection<T>