0 out of 6 rated this helpful - Rate this topic

RegexOptions Enumeration

.NET Framework 2.0

Other Versions

Provides enumerated values to use to set regular expression options.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

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

Syntax

C++

Copy

[FlagsAttribute] 
public enum RegexOptions

Copy

/** @attribute FlagsAttribute() */ 
public enum RegexOptions

JScript

Copy

FlagsAttribute 
public enum RegexOptions

Members

	Member name	Description
	Compiled	Specifies that the regular expression is compiled to an assembly. This yields faster execution but increases startup time.
	CultureInvariant	Specifies that cultural differences in language is ignored. See Performing Culture-Insensitive Operations in the RegularExpressions Namespace for more information.
	ECMAScript	Enables ECMAScript-compliant behavior for the expression. This value can be used only in conjunction with the IgnoreCase, Multiline, and Compiled values. The use of this value with any other values results in an exception.
	ExplicitCapture	Specifies that the only valid captures are explicitly named or numbered groups of the form (?<name>…). This allows unnamed parentheses to act as noncapturing groups without the syntactic clumsiness of the expression (?:…).
	IgnoreCase	Specifies case-insensitive matching.
	IgnorePatternWhitespace	Eliminates unescaped white space from the pattern and enables comments marked with #. However, the IgnorePatternWhitespace value does not affect or eliminate white space in character classes.
	Multiline	Multiline mode. Changes the meaning of ^ and $ so they match at the beginning and end, respectively, of any line, and not just the beginning and end of the entire string.
	None	Specifies that no options are set.
	RightToLeft	Specifies that the search will be from right to left instead of from left to right.
	Singleline	Specifies single-line mode. Changes the meaning of the dot (.) so it matches every character (instead of every character except \n).

Example

The following example illustrates the application of this enumeration to a Regex instance.

C++

Copy

// Define a regular expression for repeated words.
Regex rx = new Regex(@"\b(?<word>\w+)\s+(\k<word>)\b",
  RegexOptions.Compiled | RegexOptions.IgnoreCase);

Copy

// Define a regular expression for repeated words.
Regex rx = new Regex("\\b(?<word>\\w+)\\s+(\\k<word>)\\b", 
    RegexOptions.Compiled | RegexOptions.IgnoreCase);

Platforms

Windows 98, Windows 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 .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

Version Information

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Reference

System.Text.RegularExpressions Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ