共用方式為


FileSystemProxy.GetFiles 方法

定義

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

多載

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[]

要符合的模式。

傳回

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

例外狀況

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

directoryNothing

要搜尋的目錄不存在。

directory 指向現有的檔案。

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

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

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

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

範例

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

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

另請參閱

適用於

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

要搜尋的目錄。

傳回

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

例外狀況

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

directoryNothing

要搜尋的目錄不存在。

directory 指向現有的檔案。

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

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

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

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

範例

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

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

另請參閱

適用於