FileSystem.GetFiles 方法

定义

返回字符串的只读集合,这些字符串表示目录内文件的名称。

重载

GetFiles(String)

返回字符串的只读集合,这些字符串表示目录内文件的名称。

GetFiles(String, SearchOption, String[])

返回字符串的只读集合,这些字符串表示目录内文件的名称。

GetFiles(String)

Source:
FileSystem.vb
Source:
FileSystem.vb
Source:
FileSystem.vb

返回字符串的只读集合,这些字符串表示目录内文件的名称。

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);
public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory);
static member GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Shared 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 方法的任务示例。

功能 查看
获取目录中的文件集合 如何:在 Visual Basic 中获取目录中的文件集合
在目录中查找具有特定模式的文件 如何:在 Visual Basic 中查找具有特定模式的文件

另请参阅

适用于

GetFiles(String, SearchOption, String[])

Source:
FileSystem.vb
Source:
FileSystem.vb
Source:
FileSystem.vb

返回字符串的只读集合,这些字符串表示目录内文件的名称。

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);
public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);
static member GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Shared 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 方法的任务示例。

功能 查看
获取目录中的文件集合 如何:在 Visual Basic 中获取目录中的文件集合
在目录中查找具有特定模式的文件 如何:在 Visual Basic 中查找具有特定模式的文件

另请参阅

适用于