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)

Source:

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

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

注解

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

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

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

另请参阅

• SearchOption
• ReadOnlyCollection<T>

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

Source:

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

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

注解

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

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

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

另请参阅

• SearchOption
• ReadOnlyCollection<T>