This documentation is archived and is not being maintained.

Regex.Match Method (String, Int32)

Searches the input string for an occurrence of a regular expression with a specified input string starting position.

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

public Match Match (
	string input,
	int startat
public Match Match (
	String input, 
	int startat
public function Match (
	input : String, 
	startat : int
) : Match
Not applicable.



The string to search for a match.


The character position at which to start the search.

Return Value

A Regular Expression Match object.

Exception typeCondition


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

You can optionally specify a starting position in the string using the startat parameter. If you do not specify a starting position, the search begins at the default startat position. If the regular expression searches from left to right, the default startat position is at the beginning of the interval; if it searches from right to left, the default startat position is at the end of the interval.

If you want to restrict a match so it does not scan, anchor the regular expression with a \G (at the left for a left-to-right pattern, or at the right for a right-to-left pattern). This restricts the match so it must start exactly at startpos.

When a Regex is left-to-right (the default), the match and the scan proceed rightward, starting at the character specified in startat. When a Regex is right-to-left (when it is constructed with the RightToLeft option), the match and scan proceed in the opposite direction and begin with the character at startat -1.

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