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

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)。

另請參閱

• GetFiles
• 如何：尋找具有特定模式的檔案
• 如何：尋找具有特定模式的子目錄