System.IO.DirectoryInfo.EnumerateFiles Method

Returns an enumerable collection of file information that matches a search pattern.

Syntax

public IEnumerable<FileInfo> EnumerateFiles (string searchPattern)

Parameters

searchPattern
The search string to match against the names of files. This parameter can contain a combination of valid literal path and wildcard (* and ?) characters (see Remarks), but doesn't support regular expressions. The default pattern is "*", which returns all files.

Returns

An enumerable collection of files that matches searchPattern.

Remarks

searchPattern can be a combination of literal and wildcard characters, but doesn't support regular expressions. The following wildcard specifiers are permitted in searchPattern.

* (asterisk)

Zero or more characters in that position.

? (question mark)

Zero or one character in that position.

Characters other than the wildcard are literal characters. For example, the string "*t" searches for all names in ending with the letter "t". ". The searchPattern string "s*" searches for all names in path beginning with the letter "s".

The DirectoryInfo.EnumerateFiles and DirectoryInfo.GetFiles methods differ as follows:

Therefore, when you are working with many files and directories, DirectoryInfo.EnumerateFiles can be more efficient.

This method pre-populates the values of the following System.IO.FileInfo properties:

The returned collection is not cached; each call to the IEnumerable`1.GetEnumerator method on the collection will start a new enumeration.

Requirements

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