Regex.Matches Method (String, String, RegexOptions)

Searches the specified input string for all occurrences of the regular expression supplied in a pattern parameter with matching options supplied in an options parameter.

Namespace: System.Text.RegularExpressions
Assembly: System (in system.dll)

public static MatchCollection Matches (
	string input,
	string pattern,
	RegexOptions options
public static MatchCollection Matches (
	String input, 
	String pattern, 
	RegexOptions options
public static function Matches (
	input : String, 
	pattern : String, 
	options : RegexOptions
) : MatchCollection
Not applicable.



The string to search for a match.


The regular expression pattern to match.


A bitwise OR combination of RegexOption enumeration values.

Return Value

The MatchCollection of Match objects found by the search.

The Matches methods are similar to the Match methods, except they return the list of successful matches that would result from iteratively calling match= Match (...), then Match.NextMatch (), and so on. The collection includes only successful matches and terminates at the first unsuccessful match.

The static Matches methods are equivalent to constructing a Regex object with the specified regular expression pattern and calling the instance method Matches.

The pattern parameter consists of various regular expression language elements that symbolically describe the string to match. For more information about regular expressions, see .NET Framework Regular Expressions and Regular Expression Language Elements.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

XNA Framework

Supported in: 1.0