HOW TO：在 Visual Basic 中取得目錄的檔案集合

發行項
08/21/2008

更新：2007 年 11 月

My.Computer.FileSystem.GetFiles 方法會傳回字串的唯讀集合，代表目錄中檔案的名稱。您可以使用 wildCards 參數，指定特定的模式。若要將子目錄納入搜尋中，請將 searchType 參數設定為 SearchOption.SearchAllSubDirectories。

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

若要列出目錄中的檔案

使用 GetFiles 方法，並提供要搜尋之目錄的名稱和路徑。下列範例會傳回目錄中的所有檔案，並將這些檔案加入至 ListBox1。
```
For Each foundFile As String In My.Computer.FileSystem.GetFiles _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    listBox1.Items.Add(foundFile)
Next
```
這個程式碼範例也可以在 IntelliSense 程式碼片段中找到。在程式碼片段選擇器中，它是位於 [檔案系統 - 處理磁碟、資料夾和檔案] 中。如需詳細資訊，請參閱 HOW TO：在您的程式碼中插入程式碼片段 (Visual Basic)。

穩固程式設計

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

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

請參閱

工作

HOW TO：在 Visual Basic 中尋找具有特定模式的檔案

HOW TO：在 Visual Basic 中尋找具有特定模式的子目錄

參考

My.Computer.FileSystem.GetFiles 方法