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


FileSystem.FindInFiles Метод

Определение

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

Перегрузки

FindInFiles(String, String, Boolean, SearchOption)

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

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

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

FindInFiles(String, String, Boolean, SearchOption)

Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb
Исходный код:
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.

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

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

Исключения

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

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

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

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

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

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

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

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

Примеры

В этом примере выполняется поиск в каталоге 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

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

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

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

Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb
Исходный код:
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[]

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

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

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

Исключения

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

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

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

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

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

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

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

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

Примеры

В этом примере выполняется поиск в каталоге 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

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

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