Directory.EnumerateFiles Method (String, String)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Updated: October 2010

When it is called by trusted applications, returns an enumerable collection of file names that match a search pattern in a specified path.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared Function EnumerateFiles ( _
    path As String, _
    searchPattern As String _
) As IEnumerable(Of String)

public static IEnumerable<string> EnumerateFiles(
    string path,
    string searchPattern
)

searchPattern
Type: System.String
The search string to match against the names of directories in path.

Type: System.Collections.Generic.IEnumerable<String>
An enumerable collection of file names in the directory specified by path and that match searchPattern.

Exception	Condition
ArgumentException	path is a zero-length string, contains only white space, or contains invalid characters as defined by GetInvalidPathChars. - or - searchPattern does not contain a valid pattern.
ArgumentNullException	path is nulla null reference (Nothing in Visual Basic). -or- searchPattern is nulla null reference (Nothing in Visual Basic).
DirectoryNotFoundException	path is invalid, such as referring to an unmapped drive.
IOException	path is a file name.
PathTooLongException	The specified path, file name, or combined exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters and file names must be less than 260 characters.
SecurityException	The caller does not have the required permission.
UnauthorizedAccessException	The caller does not have the required permission.

The following wildcard specifiers are permitted in the searchPattern parameter.

Wildcard character	Description
*	Zero or more characters.
?	Exactly one character.

The EnumerateFiles method specifies the SearchOption.TopDirectoryOnly value for the directory to search. The application must execute as a trusted application and can only access files in user folders. For more information, see Trusted Applications.

Supported in: 5, 4

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Date	History	Reason
October 2010	Added information about the default directory and file access settings used by this method.	Information enhancement.