My.Computer.FileSystem.GetFiles 方法
更新: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 方法的工作範例。
若要 |
請參閱 |
---|---|
取得目錄中的檔案集合 |
|
在目錄中尋找具有特定模式的檔案 |
範例
下列範例會傳回目錄中的所有檔案,並將它加入至 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。
需求
命名空間:Microsoft.VisualBasic.MyServices
類別:FileSystemProxy (提供對 FileSystem 的存取)
組件:Visual Basic 執行階段程式庫 (在 Microsoft.VisualBasic.dll 中)
依專案類型的可用性
專案類型 |
是否可用 |
---|---|
Windows 應用程式 |
是 |
類別庫 |
是 |
主控台應用程式 |
是 |
Windows 控制項程式庫 |
是 |
Web 控制項程式庫 |
是 |
Windows 服務 |
是 |
網站 |
是 |
使用權限
下列使用權限可能為必要:
使用權限 |
描述 |
---|---|
控制存取檔案和資料夾的功能。關聯的列舉型別:Unrestricted。 |
請參閱
工作
HOW TO:在 Visual Basic 中尋找具有特定模式的檔案
HOW TO:在 Visual Basic 中取得目錄的檔案集合