This documentation is archived and is not being maintained.

Regex.Matches Method (String)

Searches the specified input string for all occurrences of a regular expression.

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

public MatchCollection Matches (
	string input
public MatchCollection Matches (
	String input
public function Matches (
	input : String
) : MatchCollection
Not applicable.



The string to search for a match.

Return Value

A MatchCollection of the Match objects found by the search.

Exception typeCondition


input is a null reference (Nothing in Visual Basic).

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 following code example illustrates the use of this method to find matches to a regular expression in a given String instance.

// Find matches.
MatchCollection matches = rx.Matches(text);

// Find matches.
MatchCollection matches = rx.Matches(text);

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