My.Computer.FileSystem.GetFiles 方法

發行項
08/21/2008

更新：2007 年 11 月

傳回唯讀的字串集合，表示目錄內的檔案名稱。

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

參數

directory
String。要搜尋的目錄。必要項。
searchType
SearchOption 列舉型別：是否包含子資料夾。預設值為 SearchOption.SearchTopLevelOnly。必要項。
wildcards
String。要對應的模式。必要項。

傳回值

唯讀的字串集合。

例外狀況

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

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

備註

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

工作

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

若要	請參閱
取得目錄中的檔案集合	HOW TO：在 Visual Basic 中取得目錄的檔案集合
在目錄中尋找具有特定模式的檔案	HOW TO：在 Visual Basic 中尋找具有特定模式的檔案

範例

下列範例會傳回目錄中的所有檔案，並將它加入至 ListBox1。

For Each foundFile As String In My.Computer.FileSystem.GetFiles _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    ListBox1.Items.Add(foundFile)
Next

這個範例要求您在表單中具備名為 ListBox1 的 ListBox。

這個範例會傳回目錄中所有副檔名為 .dll 的檔案，並將全部檔案加入至 ListBox1。

For Each foundFile As String In My.Computer.FileSystem.GetFiles _
      (My.Computer.FileSystem.SpecialDirectories.MyDocuments, _
       FileIO.SearchOption.SearchTopLevelOnly, "*.txt")
    ListBox1.Items.Add(foundFile)
Next

這個範例要求您在表單中具備名為 ListBox1 的 ListBox。