FileSystem.FindInFiles Метод

Определение

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

Microsoft.VisualBasic.FileIO

Сборка:

Microsoft.VisualBasic.Core.dll

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

Перегрузки

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

FindInFiles(String, String, Boolean, SearchOption)

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

FileSystem.vb

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

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ FindInFiles(System::String ^ directory, System::String ^ containsText, bool ignoreCase, Microsoft::VisualBasic::FileIO::SearchOption searchType);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType);

static member FindInFiles : string * string * bool * Microsoft.VisualBasic.FileIO.SearchOption -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function FindInFiles (directory As String, containsText As String, ignoreCase As Boolean, searchType As SearchOption) As ReadOnlyCollection(Of String)

Параметры

directory

String

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

containsText

String

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

ignoreCase

Boolean

Значение True, если при поиске следует учитывать регистр; в противном случае — значение False. Значение по умолчанию — True.

searchType

SearchOption

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

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

ReadOnlyCollection<String>

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

Исключения

ArgumentException

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

ArgumentNullException

Параметр directory имеет значение Nothing или является пустой строкой.

DirectoryNotFoundException

Заданный каталог не существует.

IOException

Заданный каталог указывает на существующий файл.

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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

Примеры

В этом примере выполняется поиск в каталоге C:\TestDir файлов, содержащих строку "sample string" , и результаты отображаются в ListBox1.

Dim list As System.Collections.ObjectModel.
  ReadOnlyCollection(Of String)
list = My.Computer.FileSystem.FindInFiles("C:\TestDir", 
 "sample string", True, FileIO.SearchOption.SearchTopLevelOnly)
For Each name In list
    ListBox1.Items.Add(name)
Next

Для работы проект должен содержать ListBox с именем ListBox1.

Комментарии

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

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

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

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

• SearchOption
• ReadOnlyCollection<T>

FindInFiles(String, String, Boolean, SearchOption, String[])

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

FileSystem.vb

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

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ FindInFiles(System::String ^ directory, System::String ^ containsText, bool ignoreCase, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ fileWildcards);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] fileWildcards);

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

Public Shared Function FindInFiles (directory As String, containsText As String, ignoreCase As Boolean, searchType As SearchOption, ParamArray fileWildcards As String()) As ReadOnlyCollection(Of String)

Параметры

directory

String

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

containsText

String

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

ignoreCase

Boolean

Значение True, если при поиске следует учитывать регистр; в противном случае — значение False. Значение по умолчанию — True.

searchType

SearchOption

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

fileWildcards

String[]

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

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

ReadOnlyCollection<String>

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

Исключения

ArgumentException

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

ArgumentNullException

Параметр directory имеет значение Nothing или является пустой строкой.

DirectoryNotFoundException

Заданный каталог не существует.

IOException

Заданный каталог указывает на существующий файл.

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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

Примеры

В этом примере выполняется поиск в каталоге C:\TestDir файлов, содержащих строку "sample string" , и результаты отображаются в ListBox1.

Dim list As System.Collections.ObjectModel.
  ReadOnlyCollection(Of String)
list = My.Computer.FileSystem.FindInFiles("C:\TestDir", 
 "sample string", True, FileIO.SearchOption.SearchTopLevelOnly)
For Each name In list
    ListBox1.Items.Add(name)
Next

Для работы проект должен содержать ListBox с именем ListBox1.

Комментарии

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

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

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

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

• SearchOption
• ReadOnlyCollection<T>