RegexOptions Výčet

Definice

Poskytuje výčtové hodnoty, které se mají použít k nastavení možností regulárního výrazu.

Tento výčet podporuje bitové kombinace hodnot jeho členů.

public enum class RegexOptions
[System.Flags]
public enum RegexOptions
[<System.Flags>]
type RegexOptions = 
Public Enum RegexOptions
Dědičnost
RegexOptions
Atributy

Pole

Compiled 8

Určuje, že regulární výraz je zkompilován do kódu JAZYKA MSIL namísto interpretace. Zkompilované regulární výrazy maximalizují výkon za běhu na úkor doby inicializace. Tato hodnota by neměla být přiřazena Options vlastnosti při volání CompileToAssembly(RegexCompilationInfo[], AssemblyName) metody. Další informace najdete v části Kompilované regulární výrazy v článku Možnosti regulárního výrazu .

CultureInvariant 512

Určuje, že kulturní rozdíly v jazyce jsou ignorovány. Další informace najdete v části Porovnání s invariantní jazykovou verzí v článku Možnosti regulárního výrazu .

ECMAScript 256

Povolí chování vyhovující standardu ECMAScript pro výraz. Tuto hodnotu lze použít pouze ve spojení s parametrem IgnoreCase, Multilinea Compiled hodnotami. Použití této hodnoty s jinými hodnotami vede k výjimce.

Další informace o ECMAScript této možnosti najdete v části "EcMAScript Matching Behavior" v článku Možnosti regulárního výrazu .

ExplicitCapture 4

Určuje, že jediné platné zachytávání jsou explicitně pojmenované nebo očíslované skupiny formuláře (?< name>...). To umožňuje, aby nepojmenované závorky fungovaly jako nešikovné skupiny bez syntaktické nešikovnosti výrazu (?:...). Další informace najdete v části Explicit Captures Only (Explicit Captures Only) v článku Možnosti regulárního výrazu .

IgnoreCase 1

Určuje porovnávání nerozlišující malá a velká písmena. Další informace naleznete v části "Porovnávání malých a malých písmen" v článku Možnosti regulárního výrazu .

IgnorePatternWhitespace 32

Eliminuje nepostřebné prázdné znaky ze vzoru a umožňuje komentáře označené znakem #. Tato hodnota ale nemá vliv na prázdné znaky ve třídách znaků, číselných kvantifikátorech nebo tokenech, které označují začátek jednotlivých elementů jazyka regulárních výrazů. Další informace najdete v části Ignorovat prázdné znaky v článku Možnosti regulárního výrazu .

Multiline 2

Víceřádkový režim. Změní význam ^ a $ tak, aby odpovídaly na začátku a konci libovolného řádku, a to nejen na začátku a konci celého řetězce. Další informace najdete v části Režim víceřádkového režimu v článku Možnosti regulárního výrazu .

NonBacktracking 1024

Povolte porovnávání pomocí přístupu, který zabraňuje zpětnému navracení a zaručuje lineární zpracování času v délce vstupu.

None 0

Určuje, že nejsou nastaveny žádné možnosti. Další informace o výchozím chování modulu regulárních výrazů naleznete v části Výchozí možnosti v článku Možnosti regulárního výrazu .

RightToLeft 64

Určuje, že hledání bude zprava doleva místo zleva doprava. Další informace najdete v části Režim zprava doleva v článku Možnosti regulárního výrazu .

Singleline 16

Určuje režim s jedním řádkem. Změní význam tečky (.), aby odpovídal každému znaku (místo každého znaku kromě \n). Další informace najdete v části Režim s jedním řádkem v článku Možnosti regulárního výrazu .

Příklady

Následující příklad definuje dva regulární výrazy, které identifikují opakující se slova v textu, ale vytvoří instanci pomocí různých RegexOptions hodnot. První regulární výraz nerozlišuje malá a velká písmena; při určování, zda je slovo stejné jako předchozí slovo, se ignoruje. Druhý regulární výraz rozlišuje malá a velká písmena; slovo musí odpovídat písmenu předchozího slova, aby bylo přesně považováno za duplicitní.

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

Poznámky

Hodnotu RegexOptions lze poskytnout jako parametr následujícím členům Regex třídy:

RegexOptions Hodnotu lze také zadat jako parametr konstruktoru RegexCompilationInfo nebo ji lze přiřadit přímo k RegexCompilationInfo.Options vlastnosti. Výsledný RegexCompilationInfo objekt se pak použije ve volání Regex.CompileToAssembly metody.

Několik možností poskytovaných členy výčtu RegexOptions (zejména jeho ExplicitCapture, , IgnoreCase``Multilinea Singleline členy) lze místo toho poskytnout pomocí znaku vložené možnosti v vzoru regulárního výrazu. Podrobnosti najdete v tématu Možnosti regulárního výrazu.

Platí pro

Viz také