Parameters

path

A string containing the name of the directory to search. [Edit]

searchPattern

A string containing the text pattern to match against the names of files in path. searchPattern cannot end with "..", or contain ".." followed by Path.DirectorySeparatorChar or Path.AltDirectorySeparatorChar. [Edit]

Returns

A string array containing the names of files in the specified directory that match the specified search pattern. [Edit]

Permissions

Type	Reason
System.Security.Permissions.FileIOPermission [Edit]	Requires permission to access path information for the specified directory and the files in that directory. See System.Security.Permissions.FileIOPermissionAccess.PathDiscovery

Exceptions

Type	Reason
ArgumentNullException	searchPattern or path is null . [Edit]
ArgumentException	path is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters. -or- searchPattern does not contain a valid pattern. [Edit]
System.IO.IOException	path is an existing file name. [Edit]
System.Security.SecurityException	The caller does not have the required permission. [Edit]
System.IO.DirectoryNotFoundException	path was not found. [Edit]
System.IO.PathTooLongException	The length of path or the absolute path information for path exceeds the system-defined maximum length. [Edit]
UnauthorizedAccessException	The caller does not have the required permission. [Edit]

Remarks

The following wild card specifiers are permitted in searchPattern:

Wild card	Description
*	Zero or more characters.
?	Exactly one character.

The period (".") character, if immediately followed by a wild card specifier, indicates that the period or the empty string matches the pattern. For example, "foo.*" and "foo.?" match "foo". Note that "foo.*" and "foo*" behave identically. If the period is not immediately followed by a wildcard, it has no special meaning (it represents a period).

Characters other than the wild card specifiers and the period always represent themselves, for example, the searchPattern string "*t" searches for all names in path ending with the letter "t". The searchPattern string "s*" searches for all names in path beginning with the letter "s".

The path argument is permitted to specify relative or absolute path information. Relative path information is interpreted as relative to the current working directory.

Note: To obtain the current working directory, see Directory.GetCurrentDirectory.

[Edit]

Requirements

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0