Freigeben über


Regex-Konstruktor (String, RegexOptions)

Initialisiert und kompiliert eine neue Instanz der Regex-Klasse für den angegebenen regulären Ausdruck mit Optionen zum Verändern des Musters.

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

Syntax

'Declaration
Public Sub New ( _
    pattern As String, _
    options As RegexOptions _
)
'Usage
Dim pattern As String
Dim options As RegexOptions

Dim instance As New Regex(pattern, options)
public Regex (
    string pattern,
    RegexOptions options
)
public:
Regex (
    String^ pattern, 
    RegexOptions options
)
public Regex (
    String pattern, 
    RegexOptions options
)
public function Regex (
    pattern : String, 
    options : RegexOptions
)

Parameter

  • pattern
    Das Muster eines regulären Ausdrucks, mit dem Übereinstimmungen gefunden werden sollen.
  • options
    Eine bitweise OR-Kombination von RegexOptions-Enumerationswerten.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentException

Fehler beim Analysieren des regulären Ausdrucks.

ArgumentNullException

pattern ist NULL (Nothing in Visual Basic).

ArgumentOutOfRangeException

options enthält ein ungültiges Flag.

Hinweise

Der pattern-Parameter besteht aus verschiedenen Sprachelementen für reguläre Ausdrücke, die die auf Übereinstimmung zu prüfende Zeichenfolge symbolisch beschreiben. Weitere Informationen über reguläre Ausdrücke finden Sie unter den Themen Reguläre Ausdrücke von .NET Framework und Sprachelemente für reguläre Ausdrücke.

Ein Regex-Objekt ist unveränderlich, d. h., es kann nur mit den bei der Erstellung definierten Übereinstimmungsparametern verwendet werden. Es kann jedoch beliebig oft ohne erneute Kompilierung verwendet werden.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie dieser Konstruktor zum Instanziieren eines regulären Ausdrucks mit einem angegebenen Muster und angegebenen Optionen verwendet wird.

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Regex-Klasse
Regex-Member
System.Text.RegularExpressions-Namespace