FileSystem.FindInFiles 方法

定義

命名空間:: Microsoft.VisualBasic.FileIO

組件:: Microsoft.VisualBasic.Core.dll

組件:: Microsoft.VisualBasic.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

回傳一個只讀的字串集合，代表包含指定文字的檔案名稱。

多載

名稱	Description
FindInFiles(String, String, Boolean, SearchOption)	回傳一個只讀的字串集合，代表包含指定文字的檔案名稱。
FindInFiles(String, String, Boolean, SearchOption, String[])	回傳一個只讀的字串集合，代表包含指定文字的檔案名稱。

FindInFiles(String, String, Boolean, SearchOption)

來源:: FileSystem.vb

來源:: FileSystem.vb

來源:: 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。

傳回

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 中操作檔案和目錄


		



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



	
		來源:
FileSystem.vb
	
	
		來源:
FileSystem.vb
	
	
		來源:
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[]
				
			
		
		圖案需要搭配。

	
	傳回



	
		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 中操作檔案和目錄

意見反應

此頁面對您有幫助嗎？