My.Computer.FileSystem.FindInFiles 方法

發行項
08/21/2008

更新：2007 年 11 月

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

' Usage
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.FindInFiles(directory ,containsText ,ignoreCase ,searchType)
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.FindInFiles(directory ,containsText ,ignoreCase ,searchType ,fileWildcards)
' Declaration
Public Function FindInFiles( _
   ByVal directory As String, _
   ByVal containsText As String, _
   ByVal ignoreCase As Boolean, _
   ByVal searchType As SearchOption _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
' -or-
Public Function FindInFiles( _
   ByVal directory As String, _
   ByVal containsText As String, _
   ByVal ignoreCase As Boolean, _
   ByVal searchType As SearchOption, _
   ByVal fileWildcards As String() _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)

參數

Directory
String：要搜尋的目錄。必要項。
containsText
String：搜尋文字。必要項。
ignoreCase
Boolean：搜尋是否應該區分大小寫。預設值為 True。必要項。
searchType
SearchOption 列舉型別：是否包含子資料夾。預設值為 SearchOption.SearchTopLevelOnly。必要項。
fileWildcards
型別 String 的陣列。要對應的模式。必要項。

傳回值

型別 String 的唯讀集合。

例外狀況

下列情形可能會造成例外狀況：

因下列其中一項原因而導致路徑無效：它是長度為零的字串、它只包含空白字元、它包含無效的字元，或者它是裝置的路徑 (開頭為 \\.\) (ArgumentException)。
路徑無效，因為它是 Nothing (ArgumentNullException)。
directory 不存在 (DirectoryNotFoundException)。
directory 會指向現有的檔案 (IOException)。
路徑超過系統定義的最大長度 (PathTooLongException)。
路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式 (NotSupportedException)。
使用者缺乏必要的使用權限來檢視路徑 (SecurityException)。
使用者缺乏必要的使用權限 (UnauthorizedAccessException)。

備註

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

工作

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

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

範例

這個範例會在目錄 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 As String In list
    ListBox1.Items.Add(name)
Next

若要成功使用，專案必須包含名為 ListBox1 的 ListBox。