Beispiel für reguläre Ausdrücke: Suchen nach HREFs

Im folgenden Beispiel wird eine Eingabezeichenfolge durchsucht, und es werden alle href="..."-Werte und ihre Positionen in der Zeichenfolge angezeigt.

Das Regex-Objekt

Da die DumpHRefs Methode mehrmals aus Benutzercode aufgerufen werden kann, verwendet sie die static (Sharedin Visual Basic)- Regex.Match(String, String, RegexOptions) Methode. Dadurch kann das Modul für reguläre Ausdrücke den regulären Ausdruck zwischenspeichern und verhindert den Aufwand beim Instanziieren eines neuen Regex Objekts bei jedem Aufruf der Methode. Anschließend wird ein Match-Objekt verwendet, mit dem alle Übereinstimmungen in der Zeichenfolge durchlaufen werden.

private static void DumpHRefs(string inputString)
{
    string hrefPattern = @"href\s*=\s*(?:[""'](?<1>[^""']*)[""']|(?<1>[^>\s]+))";

    try
    {
        Match regexMatch = Regex.Match(inputString, hrefPattern,
                                       RegexOptions.IgnoreCase | RegexOptions.Compiled,
                                       TimeSpan.FromSeconds(1));
        while (regexMatch.Success)
        {
            Console.WriteLine($"Found href {regexMatch.Groups[1]} at {regexMatch.Groups[1].Index}");
            regexMatch = regexMatch.NextMatch();
        }
    }
    catch (RegexMatchTimeoutException)
    {
        Console.WriteLine("The matching operation timed out.");
    }
}

Private Sub DumpHRefs(inputString As String)
    Dim hrefPattern As String = "href\s*=\s*(?:[""'](?<1>[^""']*)[""']|(?<1>[^>\s]+))"

    Try
        Dim regexMatch = Regex.Match(inputString, hrefPattern,
                                     RegexOptions.IgnoreCase Or RegexOptions.Compiled,
                                     TimeSpan.FromSeconds(1))
        Do While regexMatch.Success
            Console.WriteLine($"Found href {regexMatch.Groups(1)} at {regexMatch.Groups(1).Index}.")
            regexMatch = regexMatch.NextMatch()
        Loop
    Catch e As RegexMatchTimeoutException
        Console.WriteLine("The matching operation timed out.")
    End Try
End Sub

Im folgenden Beispiel wird dann ein Aufruf der DumpHRefs Methode veranschaulicht.

public static void Main()
{
    string inputString = "My favorite web sites include:</P>" +
                         "<A HREF=\"https://learn.microsoft.com/en-us/dotnet/\">" +
                         ".NET Documentation</A></P>" +
                         "<A HREF=\"http://www.microsoft.com\">" +
                         "Microsoft Corporation Home Page</A></P>" +
                         "<A HREF=\"https://devblogs.microsoft.com/dotnet/\">" +
                         ".NET Blog</A></P>";
    DumpHRefs(inputString);
}
// The example displays the following output:
//       Found href https://learn.microsoft.com/dotnet/ at 43
//       Found href http://www.microsoft.com at 114
//       Found href https://devblogs.microsoft.com/dotnet/ at 188

Public Sub Main()
    Dim inputString As String = "My favorite web sites include:</P>" &
                                "<A HREF=""https://learn.microsoft.com/en-us/dotnet/"">" &
                                ".NET Documentation</A></P>" &
                                "<A HREF=""http://www.microsoft.com"">" &
                                "Microsoft Corporation Home Page</A></P>" &
                                "<A HREF=""https://devblogs.microsoft.com/dotnet/"">" &
                                ".NET Blog</A></P>"
    DumpHRefs(inputString)
End Sub
' The example displays the following output:
'       Found href https://learn.microsoft.com/dotnet/ at 43
'       Found href http://www.microsoft.com at 114
'       Found href https://devblogs.microsoft.com/dotnet/ at 188

Das Muster für reguläre Ausdrücke href\s*=\s*(?:["'](?<1>[^"']*)["']|(?<1>[^>\s]+)) wird entsprechend der folgenden Tabelle interpretiert:

Abgleichsergebnisklasse

Die Ergebnisse einer Suche werden in der Match Klasse gespeichert, die Zugriff auf alle von der Suche extrahierten Teilzeichenfolgen ermöglicht. Es merkt sich auch die gesuchte Zeichenfolge und den verwendeten regulären Ausdruck, sodass sie die Match.NextMatch Methode aufrufen kann, um eine andere Suche auszuführen, beginnend mit dem letzten Ende.

Explizit benannte Erfassungen

In herkömmlichen regulären Ausdrücken werden erfassende Klammern automatisch fortlaufend nummeriert. Dies führt zu zwei Problemen. Erstens muss, wenn ein regulärer Ausdruck durch das Einfügen oder Entfernen eines Klammerpaarsatzes geändert wird, der gesamte Code, der auf die nummerierten Erfassungsgruppen verweist, überarbeitet werden, um die neue Nummerierung zu berücksichtigen. Zweitens, da verschiedene Klammern häufig verwendet werden, um zwei alternative Ausdrücke für eine akzeptable Übereinstimmung bereitzustellen, kann es schwierig sein zu bestimmen, welche der beiden Ausdrücke tatsächlich ein Ergebnis zurückgegeben haben.

Um diese Probleme zu beheben, unterstützt die Regex Klasse die Syntax (?<name>…) zum Erfassen einer Übereinstimmung in einem angegebenen Steckplatz (der Slot kann mit einer Zeichenfolge oder einer ganzen Zahl benannt werden; ganze Zahlen können schneller zurückgerufen werden). Damit können alle Suchergebnisse für dieselbe Zeichenfolge an denselben Ort geleitet werden. Im Fall eines Konflikts ist das zuletzt im Slot gespeicherte Suchergebnis gültig. (Eine vollständige Liste mehrerer Übereinstimmungen für einen einzelnen Slot steht jedoch zur Verfügung. Details finden Sie in der Group.Captures-Auflistung.)

Siehe auch

• Reguläre Ausdrücke von .NET