FileSystem.GetFiles 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
傳回唯讀的字串集合，而該字串集合表示目錄內檔案的名稱。
多載
| GetFiles(String) |
傳回唯讀的字串集合，而該字串集合表示目錄內檔案的名稱。 |
| GetFiles(String, SearchOption, String[]) |
傳回唯讀的字串集合，而該字串集合表示目錄內檔案的名稱。 |
GetFiles(String)
傳回唯讀的字串集合，而該字串集合表示目錄內檔案的名稱。
public:
static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory);static member GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>Public Shared Function GetFiles (directory As String) As ReadOnlyCollection(Of String)參數
- directory
- String
要搜尋的目錄。
傳回
所指定目錄中的唯讀檔案名稱集合。
例外狀況
路徑無效，原因如下：它是長度為零的字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) 。
directory 為 Nothing。
要搜尋的目錄不存在。
directory 指向現有的檔案。
路徑超過系統定義的最大長度。
路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。
使用者缺乏必要的使用權限來檢視路徑。
使用者缺乏必要的使用權限。
範例
下列範例會傳回目錄中的所有檔案，並將它們新增到 ListBox1。
For Each foundFile In My.Computer.FileSystem.GetFiles(
My.Computer.FileSystem.SpecialDirectories.MyDocuments)
ListBox1.Items.Add(foundFile)
Next
這個範例要求您在表單上具有 ListBox 名為 ListBox1 的 。
此範例會傳回目錄中延伸名為 .txt 的所有檔案，並將其新增至 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
這個範例要求您在表單上具有 ListBox 名為 ListBox1 的 。
備註
如果找不到符合指定模式的檔案，會傳回空的集合。
下表列出涉及 方法的工作 My.Computer.FileSystem.GetFiles 範例。
| 收件者 | 請參閱 |
|---|---|
| 取得目錄中檔案的集合 | 如何：在 Visual Basic 中取得目錄的檔案集合 |
| 在目錄中尋找具有特定模式的檔案 | 如何：在 Visual Basic 中尋找具有特定模式的檔案 |
另請參閱
適用於
GetFiles(String, SearchOption, String[])
傳回唯讀的字串集合，而該字串集合表示目錄內檔案的名稱。
public:
static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);static member GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>Public Shared Function GetFiles (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)參數
- directory
- String
要搜尋的目錄。
- searchType
- SearchOption
是否包含子資料夾。 預設為 SearchOption.SearchTopLevelOnly。
- wildcards
- String[]
要符合的模式。
傳回
所指定目錄中的唯讀檔案名稱集合。
例外狀況
路徑無效，原因如下：它是長度為零的字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) 。
directory 為 Nothing。
要搜尋的目錄不存在。
directory 指向現有的檔案。
路徑超過系統定義的最大長度。
路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。
使用者缺乏必要的使用權限來檢視路徑。
使用者缺乏必要的使用權限。
範例
下列範例會傳回目錄中的所有檔案，並將它們新增到 ListBox1。
For Each foundFile In My.Computer.FileSystem.GetFiles(
My.Computer.FileSystem.SpecialDirectories.MyDocuments)
ListBox1.Items.Add(foundFile)
Next
這個範例要求您在表單上具有 ListBox 名為 ListBox1 的 。
此範例會傳回目錄中延伸名為 .txt 的所有檔案，並將其新增至 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
這個範例要求您在表單上具有 ListBox 名為 ListBox1 的 。
備註
如果找不到符合指定模式的檔案，會傳回空的集合。
下表列出涉及 方法的工作 My.Computer.FileSystem.GetFiles 範例。
| 收件者 | 請參閱 |
|---|---|
| 取得目錄中檔案的集合 | 如何：在 Visual Basic 中取得目錄的檔案集合 |
| 在目錄中尋找具有特定模式的檔案 | 如何：在 Visual Basic 中尋找具有特定模式的檔案 |
