Regex.Match Method (String, String, RegexOptions)

Searches the input string for an occurrence 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 Match Match (
	string input,
	string pattern,
	RegexOptions options
public static Match Match (
	String input, 
	String pattern, 
	RegexOptions options
public static function Match (
	input : String, 
	pattern : String, 
	options : RegexOptions
) : Match
Not applicable.



The string to be tested for a match.


The regular expression pattern to match.


A bitwise OR combination of RegexOption enumeration values.

Return Value

A regular expression Match object.

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

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.

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 at startat. When a Regex is right-to-left (constructed with the RightToLeft option enabled), the match and scan are 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

Community Additions