FileSystemProxy.FindInFiles 方法

參考

定義

命名空間:: Microsoft.VisualBasic.MyServices

組件:: Microsoft.VisualBasic.dll

組件:: Microsoft.VisualBasic.Forms.dll

重要

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

傳回唯讀的字串集合，表示含有指定文字的檔案名稱。

多載

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

若要運作，項目必須包含名為 ListBox1的 ListBox 。


    	備註
    	如果找不到符合指定模式的檔案，會傳回空的集合。
下表列出涉及 My.Computer.FileSystem.FindInFiles 方法的工作範例。



收件者
請參閱




搜尋 包含特定字串之檔案的目錄
逐步解說：在 Visual Basic 中管理檔案和目錄








    	另請參閱
    	
SearchOption
ReadOnlyCollection<T>
物件 (Visual Basic)
逐步解說：在 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

若要運作，項目必須包含名為 ListBox1的 ListBox 。


    	備註
    	如果找不到符合指定模式的檔案，會傳回空的集合。
下表列出涉及 My.Computer.FileSystem.FindInFiles 方法的工作範例。



收件者
請參閱




搜尋 包含特定字串之檔案的目錄
逐步解說：在 Visual Basic 中管理檔案和目錄








    	另請參閱
    	
SearchOption
ReadOnlyCollection<T>
物件 (Visual Basic)
逐步解說：在 Visual Basic 中管理檔案和目錄


  
  適用於

共用方式為

FileSystemProxy.FindInFiles 方法

定義

多載

FindInFiles(String, String, Boolean, SearchOption)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

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

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

其他資源