My.Computer.FileSystem.GetDirectories 方法

發行項
08/21/2008

更新：2007 年 11 月

傳回代表目錄內子目錄之路徑名稱的字串集合。

 ' Usage Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetDirectories(directory) Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetDirectories(directory ,searchType ,wildcards) ' Declaration Public Function GetDirectories( _    ByVal directory As String _ ) As System.Collections.ObjectModel.ReadOnlyCollection(Of String) ' -or- Public Function GetDirectories( _    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。要符合名稱的模式。必要項。

傳回值

String 的唯讀集合。

例外狀況

下列條件可能產生例外狀況：

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

備註

您可以使用 wildcards 參數，指定特定的模式。如果您想要將子目錄的內容併入搜尋中，請將 searchType 參數設為 SearchAllSubDirectories。

如果找不到符合指定之模式的目錄，將傳回空集合。

工作

下表列出包含 My.Computer.FileSystem.GetDirectories 方法的工作範例。

若要	請參閱
列出具有特定模式的子目錄	HOW TO：在 Visual Basic 中尋找具有特定模式的子目錄

範例

下列範例會傳回目錄結構中名稱包含 Logs 一字的所有目錄，然後將它們加入至 ListBox1。

For Each foundDirectory As String In _
My.Computer.FileSystem.GetDirectories _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments, _
True, "*Logs*")
    ListBox1.Items.Add(foundDirectory)
Next

這個範例要求您在表單中具備名為 ListBox1 的 ListBox。