Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Directory.EnumerateFiles Method (String, String, SearchOption)

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, and optionally searches subdirectories.

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

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

Parameters

path
Type: System.String
The directory to search.
searchPattern
Type: System.String
The search string to match against the names of directories in path.
searchOption
Type: System.IO.SearchOption
One of the enumeration values that specifies whether the search operation should include only the current directory or should include all subdirectories.
The default value is TopDirectoryOnly.

Return Value

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

ExceptionCondition
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 null.

-or-

searchPattern is null.

ArgumentOutOfRangeException

searchOption is not a valid SearchOption value.

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 application must execute as a trusted application and can only access files in user folders. For more information, see Trusted Applications.

Silverlight

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 file access restrictions.

Information enhancement.

Community Additions

Show:
© 2014 Microsoft