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

FileSystemProxy.GetFiles Метод

  • Ссылка

Определение

Пространство имен:
Microsoft.VisualBasic.MyServices
Сборка:
Microsoft.VisualBasic.dll
Сборка:
Microsoft.VisualBasic.Forms.dll

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

Перегрузки

GetFiles(String, SearchOption, String[])

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

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

GetFiles(String, SearchOption, String[])

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

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);
public System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);
member this.GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public 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 .

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

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

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

GetFiles(String)

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

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);
public System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory);
member this.GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public 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 .

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

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

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