FileSystem.FindInFiles 方法

参考

定义

命名空间:: Microsoft.VisualBasic.FileIO

程序集:: Microsoft.VisualBasic.Core.dll

程序集:: Microsoft.VisualBasic.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

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

重载

FindInFiles(String, String, Boolean, SearchOption)	返回字符串的只读集合，这些字符串表示包含指定文本的文件的名称。
FindInFiles(String, String, Boolean, SearchOption, String[])	返回字符串的只读集合，这些字符串表示包含指定文本的文件的名称。

FindInFiles(String, String, Boolean, SearchOption)

Source:: FileSystem.vb

Source:: FileSystem.vb

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>


  
  适用于

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




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



	
		Source:
FileSystem.vb
	
	
		Source:
FileSystem.vb
	
	
		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>


  
  适用于

通过

FileSystem.FindInFiles 方法

定义

重载

FindInFiles(String, String, Boolean, SearchOption)

参数

返回

例外

示例

注解

另请参阅

适用于

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

参数

返回

例外

示例

注解

另请参阅

适用于

其他资源