Directory.GetFileSystemEntries Method |
System.IO.Directory
Directory.GetFileSystemEntries( path [, searchpattern ])
A valid path to a directory
A file specification, including wildcard characters
An array of strings, each element of which contains the name of a filesystem entry (that is, a file or directory) in the path directory
Returns the names of the filesystem entries (that is, of files and directories) in a specified directory
path can be either an absolute path (a complete path from the root directory to the directory whose entries are to be retrieved) or a relative path (starting from the current directory to the directory whose entries are to be retrieved).
path can be either a path on the local system, the path of a mapped network drive, or a UNC path.
path cannot contain wildcard characters.
If searchpattern is specified, the method returns only those filesystem entries whose names match the string, which can contain wildcard characters. Otherwise, the function returns the names of all the filesystem entries in the target directory specified by path .
If the directory specified by path has no filesystem entries, or if no filesystem entries match searchpattern , an empty array is returned.
The following code displays all filesystem entries in c:\ :
Dim sEntries( ) As String Dim i As Integer sEntries = Directory.GetFileSystemEntries("c:\") For i = 0 To UBound(sEntries) Console.WriteLine(sEntries (i)) Next
The GetFileSystemEntries method combines the functionality of the GetDirectories and GetFiles methods .
Since GetFileSystemEntries can return an empty array, you can prevent an array-access error in either of two ways: you can iterate the returned array using the For Each...Next construct, or you can retrieve the value of the UBound function, which is -1 in the case of an uninitialized array.
Directory.GetDirectories Method, Directory.GetFiles Method