RegexOptions枚举

关注

转载最新推荐文章于 2026-02-13 12:27:26 发布 664 阅读 AI 写同款· GEO 优化 ›

C#正则匹配RegexOptions选项的组合使用方法 C#中使用正则所需要引用的命名空间是 using System.Text.RegularExpressions 它包含了8个类,用得最多是的Regex，Regex不仅可以用来创建正则表达式，而且提供了很多有用的方法。首先来看一下如何创建一个Regex对象： new Regex(string pattern) new Regex(string pattern,RegexOptions options) 第一个参数是正则表达式字符串，第二个参数正则配置的选项，有以下几种选项： IgnoreCase //是匹配忽略大小写默认情况区分大小写 RightToLeft //从右到左查找字符串立即下载

`RegexOptions`枚举

提供用于设置正则表达式选项的枚举值。
此枚举具有FlagsAttribute属性，该属性允许其成员值按位组合。

[System.Flags]
public enum RegexOptions

继承 Object→ValueType→Enum→RegexOptions
特性 FlagsAttribute

Fields

名称	值	说明
`Compiled`	8	指定将正则表达式编译为程序集。这会产生更快的执行速度，但会增加启动时间。在调用 Options 方法时，不应将此值分配给 CompileToAssembly(RegexCompilationInfo[], AssemblyName) 属性。有关详细信息，请参阅正则表达式选项文章中的“已编译的正则表达式”部分。
`CultureInvariant`	512	指定忽略语言中的区域性差异。有关详细信息，请参阅正则表达式选项文章中的“使用固定区域性的比较”部分。
`ECMAScript`	256	为表达式启用符合 ECMAScript 的行为。该值只能与 IgnoreCase、Multiline 和 Compiled 值一起使用。该值与其他任何值一起使用均将导致异常。
		有关 ECMAScript 选项的详细信息，请参阅正则表达式选项文章中的“ECMAScript 匹配行为”部分。
`ExplicitCapture`	4	指定唯一有效的捕获是显式命名或编号的 `(?<name>...)` 形式的组。这使未命名的圆括号可以充当非捕获组，并且不会使表达式的语法 `(?:...)` 显得笨拙。有关详细信息，请参阅正则表达式选项文章中的“仅显式捕获”部分。
`IgnoreCase`	1	指定不区分大小写的匹配。有关详细信息，请参阅正则表达式选项文章中的“不区分大小写匹配”部分。
`IgnorePatternWhitespace`	32	消除模式中的非转义空白并启用由 `#` 标记的注释。但是，此值不影响或消除标记单独的正则表达式语言元素的开头的字符类、数值量词或标记的空格。有关详细信息，请参阅正则表达式选项一文中的“忽略空格”部分。
`Multiline`	2	多行模式。更改 `^` 和 `$` 的含义，使它们分别在任意一行的行首和行尾匹配，而不仅仅在整个字符串的开头和结尾匹配。有关详细信息，请参阅正则表达式选项文章中的“多行模式”部分。
`None`	0	指定不设置任何选项。有关正则表达式引擎的默认行为的详细信息，请参阅正则表达式选项文章中的“默认选项”部分。
`RightToLeft`	64	指定搜索从右向左而不是从左向右进行。有关详细信息，请参阅正则表达式选项文章中的“从右到左模式”部分。
`Singleline`	16	指定单行模式。更改点 `(.)` 的含义，以使它与每个字符（而不是除 `\n` 之外的所有字符）匹配。有关详细信息，请参阅正则表达式选项文章中的“单行模式”部分。

示例

下面的示例定义两个正则表达式，它们标识文本中的重复单词，但是使用不同的RegexOptions值实例化。第一个正则表达式不区分大小写；当确定一个单词是否与前一个单词相同时，忽略大小写。第二个正则表达式区分大小写；一个单词必须与前一个单词的大小写完全匹配才能被视为重复单词。

using System;
using System.Text.RegularExpressions;

public class Test
{
    public static void Main ()
    {
        // 为重复的单词定义不区分大小写的正则表达式
        Regex rxInsensitive = new Regex(@"\b(?<word>\w+)\s+(\k<word>)\b",
          RegexOptions.Compiled | RegexOptions.IgnoreCase);
        // 为重复的单词定义区分大小写的正则表达式
        Regex rxSensitive = new Regex(@"\b(?<word>\w+)\s+(\k<word>)\b",
          RegexOptions.Compiled);

        // 定义一个测试字符串  
        string text = "The the quick brown fox  fox jumps over the lazy dog dog.";
        
        // 使用不区分大小写的正则表达式查找匹配项
        MatchCollection matches = rxInsensitive.Matches(text);

        //报告找到的匹配项数
        Console.WriteLine("{0} matches found in:\n   {1}", 
                          matches.Count, 
                          text);

        // 报告每个匹配
        foreach (Match match in matches)
        {
            GroupCollection groups = match.Groups;
            Console.WriteLine("'{0}' repeated at positions {1} and {2}",  
                              groups["word"].Value, 
                              groups[0].Index, 
                              groups[1].Index);
        }
        Console.WriteLine();
        
        // 使用区分大小写的正则表达式查找匹配项
        matches = rxSensitive.Matches(text);

        //报告找到的匹配项数
        Console.WriteLine("{0} matches found in:\n   {1}", 
                          matches.Count, 
                          text);

        // 报告每个匹配
        foreach (Match match in matches)
        {
            GroupCollection groups = match.Groups;
            Console.WriteLine("'{0}' repeated at positions {1} and {2}",  
                              groups["word"].Value, 
                              groups[0].Index, 
                              groups[1].Index);
        }
    }
}
// 该示例向控制台产生以下输出
//       3 matches found in:
//          The the quick brown fox  fox jumps over the lazy dog dog.
//       'The' repeated at positions 0 and 4
//       'fox' repeated at positions 20 and 25
//       'dog' repeated at positions 50 and 54
//       
//       2 matches found in:
//          The the quick brown fox  fox jumps over the lazy dog dog.
//       'fox' repeated at positions 20 and 25
//       'dog' repeated at positions 50 and 54

备注

可以将 RegexOptions 值作为参数提供给 Regex 类的以下成员：

Regex.Regex(String, RegexOptions) 类构造函数。
Regex.Split(String, String, RegexOptions) 方法。
Regex.IsMatch(String, String, RegexOptions) 方法。
Regex.Match(String, String, RegexOptions) 方法。
Regex.Matches(String, String, RegexOptions) 方法。
Regex.Replace(String, String, String, RegexOptions) 和 Regex.Replace(String, String, MatchEvaluator, RegexOptions) 方法。

还可以将 RegexOptions 值作为参数提供给 RegexCompilationInfo 构造函数，也可以直接将其分配给 RegexCompilationInfo.Options 属性。然后，将在调用 Regex.CompileToAssembly 方法时使用生成的 RegexCompilationInfo 对象。

通过使用正则表达式模式中的内联选项字符，可以提供由 RegexOptions 枚举的成员（特别是通过其 ExplicitCapture、IgnoreCase、Multiline和 Singleline 成员）提供的多个选项。有关详细信息，请参阅正则表达式选项。

`RegexOptions`枚举

在创建Regex类的实例时，构造函数的重载中有一个要求传入RegexOptions的一个枚举值，我相信这个枚举一定非常有用，否则不会要求在构造函数中传入。今天就来看一看这个枚举的作用。

我们干脆把代码敲出来看一看：

    // 摘要:
    //     提供用于设置正则表达式选项的枚举值。
    [Flags]
    public enum RegexOptions
    {
        // 摘要:
        //     指定不设置选项。
        None = 0,
        //
        // 摘要:
        //     指定不区分大小写的匹配。
        IgnoreCase = 1,
        //
        // 摘要:
        //     多行模式。更改 ^ 和 $ 的含义，使它们分别在任意一行的行首和行尾匹配，而不仅仅在整个字符串的开头和结尾匹配。
        Multiline = 2,
        //
        // 摘要:
        //     指定有效的捕获仅为形式为 (?<name>...) 的显式命名或编号的组。这使未命名的圆括号可以充当非捕获组，并且不会使表达式的语法 (?:...)
        //     显得笨拙。
        ExplicitCapture = 4,
        //
        // 摘要:
        //     指定将正则表达式编译为程序集。这会产生更快的执行速度，但会增加启动时间。在调用 System.Text.RegularExpressions.Regex.CompileToAssembly(System.Text.RegularExpressions.RegexCompilationInfo[],System.Reflection.AssemblyName)
        //     方法时，不应将此值分配给 System.Text.RegularExpressions.RegexCompilationInfo.Options
        //     属性。
        Compiled = 8,
        //
        // 摘要:
        //     指定单行模式。更改点 (.) 的含义，使它与每一个字符匹配（而不是与除 \n 之外的每个字符匹配）。
        Singleline = 16,
        //
        // 摘要:
        //     消除模式中的非转义空白并启用由 # 标记的注释。但是，System.Text.RegularExpressions.RegexOptions.IgnorePatternWhitespace
        //     值不会影响或消除字符类中的空白。
        IgnorePatternWhitespace = 32,
        //
        // 摘要:
        //     指定搜索从右向左而不是从左向右进行。
        RightToLeft = 64,
        //
        // 摘要:
        //     为表达式启用符合 ECMAScript 的行为。该值只能与 System.Text.RegularExpressions.RegexOptions.IgnoreCase、System.Text.RegularExpressions.RegexOptions.Multiline
        //     和 System.Text.RegularExpressions.RegexOptions.Compiled 值一起使用。该值与其他任何值一起使用均将导致异常。
        ECMAScript = 256,
        //
        // 摘要:
        //     指定忽略语言中的区域性差异。有关更多信息，请参见 Performing Culture-Insensitive Operations in the
        //     RegularExpressions Namespace。
        CultureInvariant = 512,
    }

由代码可以看出这是一个标志枚举。

其实把代码复制出来之后，感觉也不是那么难懂，都是一些基本的指示。

None = 0,     　　　 //指定不设置选项。
IgnoreCase = 1,     //指定不区分大小写的匹配。
Multiline = 2,          //多行模式。更改 ^ 和 $ 的含义，使它们分别在任意一行的行首和行尾匹配，而不仅仅在整个字符串的开头和结尾匹配。
ExplicitCapture = 4,    //指定有效的捕获仅为形式为 (?<name>...) 的显式命名或编号的组。这使未命名的圆括号可以充当非捕获组，并且不会使表达式的语法 (?:...)显得笨拙。
Compiled = 8,       //指定将正则表达式编译为程序集。这会产生更快的执行速度，但会增加启动时间。在调用 System.Text.RegularExpressions.Regex.CompileToAssembly(System.Text.RegularExpressions.RegexCompilationInfo[],System.Reflection.AssemblyName)方法时，不应将此值分配给属性。
Singleline = 16,    //指定单行模式。更改点 (.) 的含义，使它与每一个字符匹配（而不是与除 \n 之外的每个字符匹配）。
IgnorePatternWhitespace = 32 //消除模式中的非转义空白并启用由 # 标记的注释。但是，System.Text.RegularExpressions.RegexOptions.IgnorePatternWhitespace值不会影　　　　　　　　　　　　响或消除字符类中的空白。
RightToLeft = 64  //指定搜索从右向左而不是从左向右进行。

ECMAScript = 256,   //为表达式启用符合 ECMAScript 的行为。该值只能与 System.Text.RegularExpressions.RegexOptions.IgnoreCase、System.Text.RegularExpressions.RegexOptions.Multiline 和 System.Text.RegularExpressions.RegexOptions.Compiled 值一起使用。该值与其他任何值一起使用均将导致异常。

CultureInvariant = 512    //指定忽略语言中的区域性差异。