My.Computer.FileSystem.GetFiles 方法

2008-08-18

更新：2007 年 11 月

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

' Usage
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetFiles(directory)
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetFiles(directory ,searchType ,wildcards)
' Declaration
Public Function GetFiles( _
   ByVal directory As String _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
' -or-
Public Function GetFiles( _
   ByVal directory As String, _
   ByVal searchType As SearchOption, _
   ByVal wildcards As String() _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)

参数

directory
String。要搜索的目录。必选。
searchType
SearchOption 枚举。是否要包括子文件夹。默认值为 SearchOption.SearchTopLevelOnly。必选。
wildcards
String。要匹配的模式。必选。

返回值

字符串的只读集合。

异常

以下情况可能会导致异常：

路径由于以下原因之一而无效：它是零长度字符串；它仅包含空白；它包含无效字符；或者它是一个设备路径（以 \\.\ 开头）(ArgumentException)。
路径无效，因为它是 Nothing (ArgumentNullException)。
directory 不存在 (DirectoryNotFoundException)。
directory 指向一个现有文件 (IOException)。
路径超过了系统定义的最大长度 (PathTooLongException)。
路径中的文件名或目录名包含冒号 (:)，或格式无效 (NotSupportedException)。
该用户缺少查看该路径所必需的权限 (SecurityException)。
用户缺少必要的权限 (UnauthorizedAccessException)。

备注

如果没有找到与指定模式匹配的文件，则返回一个空集合。

任务

下表列出了涉及 My.Computer.FileSystem.GetFiles 方法的任务的示例。

要执行的操作	请参见
获取目录中文件的集合	如何：在 Visual Basic 中获取目录中的文件集合
查找目录中具有指定模式的文件	如何：在 Visual Basic 中查找具有特定模式的文件

示例

下面的示例返回目录中的所有文件，并将这些文件添加到 ListBox1。

For Each foundFile As String In My.Computer.FileSystem.GetFiles _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    ListBox1.Items.Add(foundFile)
Next

此示例要求您的窗体上有一个名为 ListBox1 的 ListBox。

此示例返回目录中所有具有 .dll 扩展名的文件，并将这些文件添加到 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

此示例要求您的窗体上有一个名为 ListBox1 的 ListBox。