Regex-Klasse

Die System.String-Klasse beinhaltet mehrere Such- und Vergleichsmethoden, mit denen Sie Mustervergleiche mit Text ausführen können. Die Methoden String.Contains, String.EndsWith und String.StartsWith bestimmen z. B., ob eine Zeichenfolgeninstanz eine angegebene Teilzeichenfolge enthält, während die Methoden String.IndexOf, String.IndexOfAny, String.LastIndexOf und String.LastIndexOfAny die Anfangsposition einer angegebenen Teilzeichenfolge in einer Zeichenfolge zurückgeben. Verwenden Sie die Methoden der System.String-Klasse, wenn Sie nach einer bestimmten Zeichenfolge suchen. Verwenden Sie die Regex-Klasse, wenn Sie in einer Zeichenfolge nach einem bestimmten Muster suchen. Weitere Informationen und Beispiele finden Sie unter Reguläre Ausdrücke von .NET Framework.

Wenn Sie ein Muster für einen regulären Ausdruck definiert haben, gibt es zwei Möglichkeiten, dieses Muster dem Modul für reguläre Ausdrücke bereitzustellen.

• Durch das Instanziieren eines Regex-Objekts, das den regulären Ausdruck darstellt. Hierzu übergeben Sie das Muster für den regulären Ausdruck an einen Regex-Konstruktor. Ein Regex-Objekt ist unveränderlich. Wenn Sie ein Regex-Objekt mit einem regulären Ausdruck instanziieren, kann der reguläre Ausdruck dieses Objekts nicht geändert werden.

• Durch das Angeben des regulären Ausdrucks und des Suchtexts in einer static (Shared in Visual Basic) Regex-Methode. Dann können Sie einen regulären Ausdruck verwenden, ohne explizit ein Regex-Objekt zu erstellen.

Alle Regex-Musteridentifikationsmethoden beinhalten statische Überladungen und Instanzüberladungen.

Das Modul für reguläre Ausdrücke muss ein Muster kompilieren, bevor das betreffende Muster verwendet werden kann. Da Regex-Objekte unveränderlich sind, ist dies eine einmalige Prozedur, die auftritt, wenn ein Regex-Klassenkonstruktor oder eine statische Methode aufgerufen wird. Damit ein einzelner regulärer Ausdruck nicht immer wieder kompiliert werden muss, speichert das Modul für reguläre Ausdrücke die in statischen Methodenaufrufen verwendeten kompilierten regulären Ausdrücke zwischen. Dadurch bieten Mustervergleichsmethoden für reguläre Ausdrücke bei der statischen Methode und der Instanzmethode ungefähr die gleiche Leistung.

Wichtig
In .NET Framework, Versionen 1.0 und 1.1, wurden alle kompilierten regulären Ausdrücke in Instanz- oder statischen Methodenaufrufen zwischengespeichert. Ab .NET Framework 2.0 werden nur reguläre Ausdrücke zwischengespeichert, die in statischen Methodenaufrufen verwendet werden.

Das vom Modul für reguläre Ausdrücke implementierte System der Zwischenspeicherung kann sich in den folgenden zwei Fällen jedoch negativ auf die Leistung auswirken:

• Wenn Sie statische Methodenaufrufe mit einer großen Anzahl regulärer Ausdrücke verwenden. Standardmäßig werden vom Modul für reguläre Ausdrücke die 15 zuletzt verwendeten statischen regulären Ausdrücke zwischengespeichert. Wenn die Anwendung mehr als 15 statische reguläre Ausdrücke verwendet, müssen einige reguläre Ausdrücke neu kompiliert werden. Um diese Neukompilierung zu verhindern, können Sie die Regex.CacheSize-Eigenschaft auf einen entsprechenden Wert erhöhen.

• Wenn die Anwendung neue Regex-Objekte mit regulären Ausdrücken instanziiert, die bereits kompiliert wurden. Im folgenden Code wird z. B. ein regulärer Ausdruck definiert, um doppelte Wörter in einzelnen Zeilen eines Textstreams zu suchen. Obwohl im Beispiel ein einzelner regulärer Ausdruck verwendet wird, instanziiert es ein neues Regex-Objekt, um jede Textzeile zu verarbeiten. Dies führt bei jeder Iteration der Schleife zur Neukompilierung des regulären Ausdrucks.

  C#

  VB

  Kopieren

  
  StreamReader sr = new StreamReader(filename);
  string input;
  string pattern = @"\b(\w+)\s\1\b";
  while (sr.Peek() >= 0)
  {
     input = sr.ReadLine();
     Regex rgx = new Regex(pattern, RegexOptions.IgnoreCase);
     MatchCollection matches = rgx.Matches(input);
     if (matches.Count > 0)
     {
        Console.WriteLine("{0} ({1} matches):", input, matches.Count);
        foreach (Match match in matches)
           Console.WriteLine("   " + match.Value);
     }
  }
  sr.Close();   
  
  
  

  Um die Neukompilierung zu verhindern, sollte die Anwendung ein einzelnes Regex-Objekt instanziieren, auf das jeder Code bei Bedarf zugreifen kann, wie im Folgenden umgeschriebenen Beispiel gezeigt.

  C#

  VB

  Kopieren

  
  StreamReader sr = new StreamReader(filename);
  string input;
  string pattern = @"\b(\w+)\s\1\b";
  Regex rgx = new Regex(pattern, RegexOptions.IgnoreCase);
  
  while (sr.Peek() >= 0)
  {
     input = sr.ReadLine();
     MatchCollection matches = rgx.Matches(input);
     if (matches.Count > 0)
     {
        Console.WriteLine("{0} ({1} matches):", input, matches.Count);
        foreach (Match match in matches)
           Console.WriteLine("   " + match.Value);
     }
  }
  sr.Close();   
  
  
  

Wenn Sie ein Regex-Objekt instanziieren und seine Methoden aufrufen oder statische Methoden aufrufen möchten, bietet die Regex-Klasse die folgende Mustervergleichsfunktionalität an:

• Validierung einer Übereinstimmung. Sie rufen die IsMatch-Methode auf, um zu bestimmen, ob eine Übereinstimmung vorhanden ist.

• Abruf einer einzelnen Übereinstimmung. Sie rufen die Match-Methode auf, um ein Match-Objekt abzurufen, das die erste Übereinstimmung in einer Zeichenfolge oder einem Teil einer Zeichenfolge darstellt. Nachfolgende Übereinstimmungen können durch Aufrufen der Match.NextMatch-Methode aufgerufen werden.

• Abruf aller Übereinstimmungen. Sie rufen die Matches-Methode auf, um ein System.Text.RegularExpressions.MatchCollection-Objekt abzurufen, das alle in einer Zeichenfolge oder einem Teil einer Zeichenfolge gefundenen Übereinstimmungen darstellt.

• Ersetzen des übereinstimmenden Texts. Sie rufen die Replace-Methode auf, um übereinstimmenden Text zu ersetzen. Der Ersetzungstext kann auch von einem regulären Ausdruck definiert werden. Darüber hinaus beinhalten einige der Replace-Methoden einen MatchEvaluator-Parameter, mit dem Sie den Ersetzungstext programmgesteuert definieren können.

• Erstellung eines Zeichenfolgenarrays, das von Teilen einer Eingabezeichenfolge gebildet wird. Sie rufen die Split-Methode auf, um eine Eingabezeichenfolge an Positionen zu teilen, die vom regulären Ausdruck definiert werden.

Neben den Mustervergleichsmethoden beinhaltet die Regex-Klasse mehrere Methoden für besondere Zwecke:

• Die Escape-Methode versieht alle Zeichen mit einem Escapezeichen, die in einem regulären Ausdruck oder einer Eingabezeichenfolge möglicherweise als reguläre Ausdrucksoperatoren interpretiert werden.

• Die Unescape-Methode entfernt diese Escapezeichen.

• Die CompileToAssembly-Methode erstellt eine Assembly, die vordefinierte reguläre Ausdrücke enthält. .NET Framework enthält Beispiele für diese zweckgebundenen Assemblys im System.Web.RegularExpressions-Namespace.