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

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

備註

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

下表列出涉及 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

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

備註

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

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

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

另請參閱

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