DirectoryInfo.EnumerateFiles Method (String)
Returns an enumerable collection of file information that matches a search pattern.
Assembly: mscorlib (in mscorlib.dll)
- Type: System.String
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.
searchPattern can be a combination of literal and wildcard characters, but doesn't support regular expressions. The following wildcard specifiers are permitted in searchPattern.
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".
Therefore, when you are working with many files and directories, EnumerateFiles can be more efficient.
This method pre-populates the values of the following FileInfo properties:
The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.
The following example shows how to enumerate files in a directory by using different search options. The example assumes a directory that has files named log1.txt, log2.txt, test1.txt, test2.txt, test3.txt, and a subdirectory that has a file named SubFile.txt.