FileSystem.GetDirectories 方法

定義

命名空間:

Microsoft.VisualBasic.FileIO

組件:

Microsoft.VisualBasic.Core.dll

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

多載

GetDirectories(String)	傳回字串的集合，表示目錄內子目錄的路徑名稱。
GetDirectories(String, SearchOption, String[])	傳回字串的集合，表示目錄內子目錄的路徑名稱。

GetDirectories(String)

來源:

FileSystem.vb

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

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetDirectories(System::String ^ directory);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetDirectories (string directory);

static member GetDirectories : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function GetDirectories (directory As String) As ReadOnlyCollection(Of String)

參數

directory

String

目錄的名稱和路徑。

傳回

ReadOnlyCollection<String>

在指定目錄內，子目錄路徑名稱的唯讀集合。

例外狀況

ArgumentException

路徑無效，原因如下：它是長度為零的字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) 。

ArgumentNullException

directory 為 Nothing 或空字串。

DirectoryNotFoundException

指定的目錄不存在。

IOException

指定的目錄指向現有的檔案。

PathTooLongException

路徑超過系統定義的最大長度。

NotSupportedException

路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。

SecurityException

使用者缺乏必要的使用權限來檢視路徑。

UnauthorizedAccessException

使用者缺乏必要的使用權限。

範例

下列範例會傳回目錄結構中的所有目錄，其中包含其名稱中的單字 Logs ，並將其新增至 ListBox1。

For Each foundDirectory In My.Computer.FileSystem.GetDirectories(
      My.Computer.FileSystem.SpecialDirectories.MyDocuments,
      True, "*Logs*")

    ListBox1.Items.Add(foundDirectory)
Next

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

備註

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

收件者	請參閱
列出具有特定模式的子目錄	如何：在 Visual Basic 中尋找具有特定模式的子目錄

另請參閱

• SearchOption
• ReadOnlyCollection<T>

GetDirectories(String, SearchOption, String[])

來源:

FileSystem.vb

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

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetDirectories(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetDirectories (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);

static member GetDirectories : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function GetDirectories (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)

參數

directory

String

目錄的名稱和路徑。

searchType

SearchOption

是否包含子資料夾。 預設為 SearchOption.SearchTopLevelOnly。

wildcards

String[]

要符合名稱的模式。

傳回

ReadOnlyCollection<String>

在指定目錄內，子目錄路徑名稱的唯讀集合。

例外狀況

ArgumentException

路徑無效，原因如下：它是長度為零的字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) 。

ArgumentNullException

一個或多個指定的萬用字元 (Wildcard Character) 為 Nothing、空字串，或只包含空格。

DirectoryNotFoundException

指定的目錄不存在。

IOException

指定的目錄指向現有的檔案。

PathTooLongException

路徑超過系統定義的最大長度。

NotSupportedException

路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。

SecurityException

使用者缺乏必要的使用權限來檢視路徑。

UnauthorizedAccessException

使用者缺乏必要的使用權限。

範例

下列範例會傳回目錄結構中的所有目錄，其中包含其名稱中的單字 Logs ，並將其新增至 ListBox1。

For Each foundDirectory In My.Computer.FileSystem.GetDirectories(
      My.Computer.FileSystem.SpecialDirectories.MyDocuments,
      True, "*Logs*")

    ListBox1.Items.Add(foundDirectory)
Next

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

備註

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

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

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

收件者	請參閱
列出具有特定模式的子目錄	如何：在 Visual Basic 中尋找具有特定模式的子目錄

另請參閱

• SearchOption
• ReadOnlyCollection<T>