This topic has not yet been rated - Rate this topic

Directory.EnumerateFiles Method (String, String, SearchOption)

Silverlight

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)

Syntax

Copy

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.

Exceptions

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