FileSystemProxy.FindInFiles 方法

定义

命名空间:

Microsoft.VisualBasic.MyServices

程序集:

Microsoft.VisualBasic.Forms.dll

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

重载

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。

返回

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>
• 对象 (Visual Basic)
• 演练：在 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[]

要匹配的模式。

返回

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>
• 对象 (Visual Basic)
• 演练：在 Visual Basic 中操作文件和目录