如何：在 Visual Basic 中取得目錄的檔案集合

發行項
03/05/2024

FileSystem.GetFiles 方法的多載會傳回唯讀的字串集合，代表了目錄內的檔案名稱：

使用 GetFiles(String) 多載在指定目錄中進行簡單的檔案搜尋，而不搜尋子目錄。
使用 GetFiles(String, SearchOption, String[]) 多載指定搜尋的其他選項。您可以使用 wildCards 參數，指定搜尋模式。若要在搜尋中包含子目錄，請將 searchType 參數設成 SearchOption.SearchAllSubDirectories。

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

列出目錄中的檔案

使用其中一個 FileSystem.GetFiles 方法多載，並在 directory 參數中提供要搜尋的目錄名稱和路徑。下列範例會傳回目錄中的所有檔案，並將它們新增到 ListBox1。
```
For Each foundFile As String In My.Computer.FileSystem.GetFiles(
  My.Computer.FileSystem.SpecialDirectories.MyDocuments)

    listBox1.Items.Add(foundFile)
Next
```

穩固程式設計

以下條件可能會造成例外狀況：

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

另請參閱