Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

Regex.Match-Methode (String)

Durchsucht die angegebene Eingabezeichenfolge nach dem ersten Vorkommen des im Regex-Konstruktor angegebenen regulären Ausdrucks.

Namespace:  System.Text.RegularExpressions
Assembly:  System (in System.dll)
public Match Match(
	string input
)

Parameter

input
Typ: System.String
Die nach einer Übereinstimmung zu durchsuchende Zeichenfolge.

Rückgabewert

Typ: System.Text.RegularExpressions.Match
Ein Objekt, das Informationen zur Entsprechung enthält.
Ausnahme Bedingung
ArgumentNullException

input hat den Wert null.

Sie können bestimmen, ob das Muster eines regulären Ausdrucks in der Eingabezeichenfolge gefunden wurde, indem Sie den Wert der zurückgegebenen Success-Eigenschaft des Match-Objekts überprüfen. Wenn eine Übereinstimmung erfolgreich ist, enthält die Value-Eigenschaft des Match-Objekts die Teilzeichenfolge aus input, die dem Muster des regulären Ausdrucks entspricht. Wenn keine Übereinstimmung gefunden wurde, lautet der Wert String.Empty.

Diese Methode gibt die erste Teilzeichenfolge in input zurück, die mit dem Muster eines regulären Ausdrucks übereinstimmt. Sie können nachfolgende Übereinstimmungen abrufen, indem Sie die zurückgegebene Match.NextMatch-Methode des Match-Objekts wiederholt aufrufen. Sie können alle Übereinstimmungen auch in einem einzelnen Methodenaufruf abrufen, indem Sie die Regex.Matches(String)-Methode aufrufen.

Im folgenden Codebeispiel werden Übereinstimmungen eines Musters für einen regulären Ausdruck in einer Zeichenfolge gesucht, und dann werden die übereinstimmenden Gruppen, Fundstellen und Fundstellenpositionen aufgeführt.


using System;
using System.Text.RegularExpressions;

class Example 
{
   static void Main() 
   {
      string text = "One car red car blue car";
      string pat = @"(\w+)\s+(car)";

      // Instantiate the regular expression object.
      Regex r = new Regex(pat, RegexOptions.IgnoreCase);

      // Match the regular expression pattern against a text string.
      Match m = r.Match(text);
      int matchCount = 0;
      while (m.Success) 
      {
         Console.WriteLine("Match"+ (++matchCount));
         for (int i = 1; i <= 2; i++) 
         {
            Group g = m.Groups[i];
            Console.WriteLine("Group"+i+"='" + g + "'");
            CaptureCollection cc = g.Captures;
            for (int j = 0; j < cc.Count; j++) 
            {
               Capture c = cc[j];
               System.Console.WriteLine("Capture"+j+"='" + c + "', Position="+c.Index);
            }
         }
         m = m.NextMatch();
      }
   }
}
// This example displays the following output:
//       Match1
//       Group1='One'
//       Capture0='One', Position=0
//       Group2='car'
//       Capture0='car', Position=4
//       Match2
//       Group1='red'
//       Capture0='red', Position=8
//       Group2='car'
//       Capture0='car', Position=12
//       Match3
//       Group1='blue'
//       Capture0='blue', Position=16
//       Group2='car'
//       Capture0='car', Position=21


.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Unterstützt in:

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ