FileSystemProxy.FindInFiles 方法

定义

返回字符串的只读集合,这些字符串表示包含指定文本的文件的名称。

重载

FindInFiles(String, String, Boolean, SearchOption)

返回字符串的只读集合,这些字符串表示包含指定文本的文件的名称。

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

返回字符串的只读集合,这些字符串表示包含指定文本的文件的名称。

FindInFiles(String, String, Boolean, SearchOption)

返回字符串的只读集合,这些字符串表示包含指定文本的文件的名称。

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ FindInFiles(System::String ^ directory, System::String ^ containsText, bool ignoreCase, Microsoft::VisualBasic::FileIO::SearchOption searchType);
public System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType);
member this.FindInFiles : string * string * bool * Microsoft.VisualBasic.FileIO.SearchOption -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public 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>) 。

directoryNothing 或空字符串。

指定的目录不存在。

指定的目录指向某个现有文件。

路径超过了系统定义的最大长度。

指定的目录路径中包含冒号 (:),或格式无效。

该用户缺少查看该路径所必需的权限。

该用户缺少必要的权限。

示例

此示例在目录中 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

若要正常工作,项目必须包含名为 ListBoxListBox1的 。

注解

如果没有找到与指定模式匹配的文件,则返回一个空集合。

下表列出了涉及 My.Computer.FileSystem.FindInFiles 方法的任务示例。

功能 查看
为包含特定字符串的文件搜索目录 演练:在 Visual Basic 中操作文件和目录

另请参阅

适用于

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

返回字符串的只读集合,这些字符串表示包含指定文本的文件的名称。

public:
 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 System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] fileWildcards);
member this.FindInFiles : string * string * bool * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public 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>) 。

directoryNothing 或空字符串。

指定的目录不存在。

指定的目录指向某个现有文件。

路径超过了系统定义的最大长度。

指定的目录路径中包含冒号 (:),或格式无效。

该用户缺少查看该路径所必需的权限。

该用户缺少必要的权限。

示例

此示例在目录中 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

若要正常工作,项目必须包含名为 ListBoxListBox1的 。

注解

如果没有找到与指定模式匹配的文件,则返回一个空集合。

下表列出了涉及 My.Computer.FileSystem.FindInFiles 方法的任务示例。

功能 查看
为包含特定字符串的文件搜索目录 演练:在 Visual Basic 中操作文件和目录

另请参阅

适用于