共用方式為


FileSystemProxy.FindInFiles 方法

定義

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

多載

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

傳回

包含指定文字的檔案名稱唯讀集合。

例外狀況

路徑無效,原因如下:它是零長度字串;它只包含空格符;它包含無效的字元;或它是 (開頭為 \的裝置路徑。</code>) 。

directoryNothing 或空字串。

指定的目錄不存在。

指定的目錄指向現有的檔案。

路徑超過系統定義的最大長度。

指定的目錄路徑包含冒號 (:) 或格式無效。

使用者缺乏必要的使用權限來檢視路徑。

使用者缺乏必要的使用權限。

範例

此範例會搜尋目錄 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

若要運作,項目必須包含名為 ListBox1ListBox

備註

如果找不到符合指定模式的檔案,會傳回空的集合。

下表列出涉及 My.Computer.FileSystem.FindInFiles 方法的工作範例。

收件者 請參閱
搜尋 包含特定字串之檔案的目錄 逐步解說:在 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[]

要符合的模式。

傳回

包含指定文字的檔案名稱唯讀集合。

例外狀況

路徑無效,原因如下:它是零長度字串;它只包含空格符;它包含無效的字元;或它是 (開頭為 \的裝置路徑。</code>) 。

directoryNothing 或空字串。

指定的目錄不存在。

指定的目錄指向現有的檔案。

路徑超過系統定義的最大長度。

指定的目錄路徑包含冒號 (:) 或格式無效。

使用者缺乏必要的使用權限來檢視路徑。

使用者缺乏必要的使用權限。

範例

此範例會搜尋目錄 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

若要運作,項目必須包含名為 ListBox1ListBox

備註

如果找不到符合指定模式的檔案,會傳回空的集合。

下表列出涉及 My.Computer.FileSystem.FindInFiles 方法的工作範例。

收件者 請參閱
搜尋 包含特定字串之檔案的目錄 逐步解說:在 Visual Basic 中管理檔案和目錄

另請參閱

適用於