FileSystemProxy.GetFiles 方法

定義

命名空間:

Microsoft.VisualBasic.MyServices

組件:

Microsoft.VisualBasic.Forms.dll

傳回唯讀的字串集合，而該字串集合表示目錄內檔案的名稱。

多載

GetFiles(String, SearchOption, String[])	傳回唯讀的字串集合，而該字串集合表示目錄內檔案的名稱。
GetFiles(String)	傳回唯讀的字串集合，而該字串集合表示目錄內檔案的名稱。

GetFiles(String, SearchOption, String[])

傳回唯讀的字串集合，而該字串集合表示目錄內檔案的名稱。

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

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

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

Public Function GetFiles (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

directory 為 Nothing。

DirectoryNotFoundException

要搜尋的目錄不存在。

IOException

directory 指向現有的檔案。

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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

範例

下列範例會傳回目錄中的所有檔案，並將它們新增到 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 範例。

收件者	請參閱
取得目錄中檔案的集合	作法：取得目錄中的檔案集合
在目錄中尋找具有特定模式的檔案	作法：尋找具有特定模式的檔案

另請參閱

• SearchOption
• ReadOnlyCollection<T>
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中尋找具有特定模式的檔案
• 如何：在 Visual Basic 中取得目錄的檔案集合

GetFiles(String)

傳回唯讀的字串集合，而該字串集合表示目錄內檔案的名稱。

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

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

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

Public Function GetFiles (directory As String) As ReadOnlyCollection(Of String)

參數

directory

String

要搜尋的目錄。

傳回

ReadOnlyCollection<String>

所指定目錄中的唯讀檔案名稱集合。

例外狀況

ArgumentException

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

ArgumentNullException

directory 為 Nothing。

DirectoryNotFoundException

要搜尋的目錄不存在。

IOException

directory 指向現有的檔案。

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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

範例

下列範例會傳回目錄中的所有檔案，並將它們新增到 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 範例。

收件者	請參閱
取得目錄中檔案的集合	作法：取得目錄中的檔案集合
在目錄中尋找具有特定模式的檔案	作法：尋找具有特定模式的檔案

另請參閱

• ReadOnlyCollection<T>
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中尋找具有特定模式的檔案
• 如何：在 Visual Basic 中取得目錄的檔案集合