RegexOptions 列舉

參考

定義

命名空間:: System.Text.RegularExpressions

組件:: System.Text.RegularExpressions.dll

組件:: System.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

提供用來設定規則運算式 (Regular Expression) 選項的列舉值。

此列舉支援其成員值的位元組合。

public enum class RegexOptions

[System.Flags]
public enum RegexOptions

[<System.Flags>]
type RegexOptions =

Public Enum RegexOptions

繼承: Object

ValueType

Enum
RegexOptions

屬性: FlagsAttribute

欄位

Compiled	8	指定正則表達式會編譯為 MSIL 程式代碼，而不是解譯。編譯的規則運算式可充分提升執行時期效能，但會犧牲初始化時間。在呼叫 Options 方法時，不應將這個值指派至 CompileToAssembly(RegexCompilationInfo[], AssemblyName) 屬性。如需詳細資訊，請參閱正則表達式選項一文中的一節。
CultureInvariant	512	指定忽略語言中的文化差異。如需詳細資訊，請參閱正則表達式選項一文中的一節。
ECMAScript	256	啟用運算式的 ECMAScript 相容行為。這個值只能結合 IgnoreCase、Multiline 和 Compiled 值使用，將這個值與任何其他值一起使用都將導致例外狀況。 For more information on the ECMAScript option, see the "ECMAScript Matching Behavior" section in the Regular Expression Options article.
ExplicitCapture	4	指定表單的唯一有效擷取是明確命名或編號的群組 (？<name>...) 。這可讓未命名的括號做為非擷取群組，而不使用表達式的語法 (？：...) 。如需詳細資訊，請參閱正則表達式選項一文中的一節。
IgnoreCase	1	指定區分大小寫的比對。如需詳細資訊，請參閱正則表達式選項一文中的「不區分大小寫比對」一節。
IgnorePatternWhitespace	32	從模式排除未逸出的空白字元 (White Space)，並啟用以 # 標記的註解。不過，這個值不會影響或排除字元類別中的空白字元、數值數量詞，或是標示個別規則運算式語言項目開始的權杖。如需詳細資訊，請參閱規則運算式選項一文中的＜忽略空白字元＞一節。
Multiline	2	多行模式。變更 ^ 和 $ 的意義以致它們分別在任何一行的開頭和結尾做比對，而不只是整個字串的開頭和結尾。如需詳細資訊，請參閱正則表達式選項一文中的一節。
NonBacktracking	1024	使用可避免回溯的方法進行比對，並保證輸入長度的線性時間處理。
None	0	指定無選項設定。如需正則表達式引擎之預設行為的詳細資訊，請參閱正則表示式選項一文中的一節。
RightToLeft	64	指定搜尋將由右至左，而非由左至右。如需詳細資訊，請參閱正則表達式選項一文中的一節。
Singleline	16	指定單行模式。變更點 (.) 的意義，使它符合一切字元 (而不是 \n 之外的一切字元)。如需詳細資訊，請參閱正則表達式選項一文中的一節。

範例

下列範例會定義兩個正則表達式，這些正則表達式會識別文字中的重複單字，但會使用不同的 RegexOptions 值具現化。第一個正則表示式不區分大小寫;判斷單字是否與上述單字相同時，會忽略 case。第二個正則表示式區分大小寫;單字必須完全符合上述單字的大小寫，才能視為重複。

using System;
using System.Text.RegularExpressions;

public class Test
{
    public static void Main ()
    {
        // Define a case-insensitive regular expression for repeated words.
        Regex rxInsensitive = new Regex(@"\b(?<word>\w+)\s+(\k<word>)\b",
          RegexOptions.Compiled | RegexOptions.IgnoreCase);
        // Define a case-sensitive regular expression for repeated words.
        Regex rxSensitive = new Regex(@"\b(?<word>\w+)\s+(\k<word>)\b",
          RegexOptions.Compiled);

        // Define a test string.        
        string text = "The the quick brown fox  fox jumps over the lazy dog dog.";
        
        // Find matches using case-insensitive regular expression.
        MatchCollection matches = rxInsensitive.Matches(text);

        // Report the number of matches found.
        Console.WriteLine("{0} matches found in:\n   {1}", 
                          matches.Count, 
                          text);

        // Report on each match.
        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();
        
        // Find matches using case-sensitive regular expression.
        matches = rxSensitive.Matches(text);

        // Report the number of matches found.
        Console.WriteLine("{0} matches found in:\n   {1}", 
                          matches.Count, 
                          text);

        // Report on each match.
        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);
        }
    }
}
// The example produces the following output to the console:
//       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

Imports System.Text.RegularExpressions

Public Module Test

    Public Sub Main()
        ' Define a case-insensitive regular expression for repeated words.
        Dim rxInsensitive As New Regex("\b(?<word>\w+)\s+(\k<word>)\b", _
               RegexOptions.Compiled Or RegexOptions.IgnoreCase)
        ' Define a case-sensitive regular expression for repeated words.
        Dim rxSensitive As New Regex("\b(?<word>\w+)\s+(\k<word>)\b", _
               RegexOptions.Compiled)

        ' Define a test string.        
        Dim text As String = "The the quick brown fox  fox jumps over the lazy dog dog."
        
        ' Find matches using case-insensitive regular expression.
        Dim matches As MatchCollection = rxInsensitive.Matches(text)

        ' Report the number of matches found.
        Console.WriteLine("{0} matches found in:", matches.Count)
        Console.WriteLine("   {0}", text)

        ' Report on each match.
        For Each match As Match In matches
            Dim groups As GroupCollection = match.Groups
            Console.WriteLine("'{0}' repeated at positions {1} and {2}", _ 
                              groups.Item("word").Value, _
                              groups.Item(0).Index, _
                              groups.Item(1).Index)
        Next
        Console.WriteLine()
        
        ' Find matches using case-sensitive regular expression.
        matches = rxSensitive.Matches(text)

        ' Report the number of matches found.
        Console.WriteLine("{0} matches found in:", matches.Count)
        Console.WriteLine("   {0}", text)

        ' Report on each match.
        For Each match As Match In matches
            Dim groups As GroupCollection = match.Groups
            Console.WriteLine("'{0}' repeated at positions {1} and {2}", _ 
                              groups.Item("word").Value, _
                              groups.Item(0).Index, _
                              groups.Item(1).Index)
        Next
        Console.WriteLine()
    End Sub
End Module
' The example produces the following output to the console:
'       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 屬性。然後，產生的 RegexCompilationInfo 物件會在呼叫 Regex.CompileToAssembly 方法時使用。

列舉成員 RegexOptions 所提供的數個選項 (，其 ExplicitCapture、 IgnoreCase、 Multiline和 Singleline 成員) 可以改為使用正則表示式模式中的內嵌選項字元來提供。如需詳細資訊，請參閱正則表達式選項。

適用於

共用方式為

RegexOptions 列舉

定義

欄位

範例

備註

適用於

另請參閱

其他資源