FileSystemProxy.GetDirectories 方法

定義

命名空間:

Microsoft.VisualBasic.MyServices

組件:

Microsoft.VisualBasic.Forms.dll

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

多載

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

GetDirectories(String)

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

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

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

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

Public 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 範例。

收件者	請參閱
列出具有特定模式的子目錄	作法：尋找具有特定模式的子目錄

另請參閱

• SearchOption
• ReadOnlyCollection<T>
• 物件 (Visual Basic)

GetDirectories(String, SearchOption, String[])

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

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

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

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

Public 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 範例。

收件者	請參閱
列出具有特定模式的子目錄	作法：尋找具有特定模式的子目錄

另請參閱

• SearchOption
• ReadOnlyCollection<T>
• 物件 (Visual Basic)