Match Klasse

Definition

Namespace:
System.Text.RegularExpressions
Assemblys:
System.dll, System.Text.RegularExpressions.dll
Assemblys:
netstandard.dll, System.Text.RegularExpressions.dll
Assembly:
System.Text.RegularExpressions.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Quelle:
Match.cs
Quelle:
Match.cs
Quelle:
Match.cs
Quelle:
Match.cs
Quelle:
Match.cs

Stellt die Ergebnisse einer übereinstimmung mit einem einzelnen regulären Ausdruck dar.

public ref class Match : System::Text::RegularExpressions::Group
public class Match : System.Text.RegularExpressions.Group
[System.Serializable]
public class Match : System.Text.RegularExpressions.Group
type Match = class
    inherit Group
[<System.Serializable>]
type Match = class
    inherit Group
Public Class Match
Inherits Group
Vererbung
Object
Capture
Group
Match
Attribute
SerializableAttribute

Hinweise

Die Match Klasse ist unveränderlich und weist keinen öffentlichen Konstruktor auf. Eine Instanz der Match Klasse wird von der Match(String) Methode zurückgegeben und stellt die erste Mustervergleichung in einer Zeichenfolge dar. Nachfolgende Übereinstimmungen werden durch Match objekte dargestellt, die von der NextMatch() Methode zurückgegeben werden. Darüber hinaus wird ein MatchCollection Objekt, das aus Null, einem oder mehreren Match Objekten besteht, von der Matches(String) Methode zurückgegeben.

Wenn die Matches(String) Methode nicht mit einem Muster für reguläre Ausdrücke in einer Eingabezeichenfolge übereinstimmt, wird ein leeres MatchCollection Objekt zurückgegeben. Anschließend können Sie ein foreach Konstrukt verwenden, um die Sammlung zu durchlaufen.

Wenn die Match(String) Methode nicht mit dem Muster für reguläre Ausdrücke übereinstimmt, wird ein Match Objekt zurückgegeben, das gleich ist Empty. Mit der Success Eigenschaft können Sie ermitteln, ob die Übereinstimmung erfolgreich war.

Wenn eine Musterüberstimmung erfolgreich ist, enthält die Value Eigenschaft die übereinstimmende Teilzeichenfolge, die Index Eigenschaft gibt die nullbasierte Anfangsposition der übereinstimmenden Teilzeichenfolge in der Eingabezeichenfolge an, und die Length Eigenschaft gibt die Länge der übereinstimmenden Teilzeichenfolge in der Eingabezeichenfolge an.

Da eine einzelne Übereinstimmung mehrere Aufnahmegruppen umfassen kann, verfügt sie über eine Match Eigenschaft, Groups die den GroupCollectionWert zurückgibt. Die Match Instanz selbst entspricht dem ersten Objekt in der Auflistung, bei Match.Groups[0]dem die gesamte Übereinstimmung dargestellt wird.

Eigenschaften

Name Beschreibung
Captures

Ruft eine Auflistung aller Aufzeichnungen ab, die von der Aufnahmegruppe abgeglichen werden, in der innersten Reihenfolge ganz links und ganz links (oder innerstes rechtstes Erstes, wenn der reguläre Ausdruck mit der RightToLeft Option geändert wird). Die Auflistung kann null oder mehr Elemente enthalten.

(Geerbt von Group)
Empty

Ruft die leere Übereinstimmung ab. Alle fehlgeschlagenen Übereinstimmungen geben diese leere Übereinstimmung zurück.
Groups

Ruft eine Auflistung von Gruppen ab, die mit dem regulären Ausdruck übereinstimmen.
Index

Ruft die Position in der ursprünglichen Zeichenfolge ab, an der das erste Zeichen der erfassten Teilzeichenfolge gefunden wird.

(Geerbt von Capture)
Length

Ruft die Länge der erfassten Teilzeichenfolge ab.

(Geerbt von Capture)
Name

Gibt den Namen der Aufnahmegruppe zurück, die durch die aktuelle Instanz dargestellt wird.

(Geerbt von Group)
Success

Ruft einen Wert ab, der angibt, ob die Übereinstimmung erfolgreich ist.

(Geerbt von Group)
Value

Ruft die erfasste Teilzeichenfolge aus der Eingabezeichenfolge ab.

(Geerbt von Capture)
ValueSpan

Ruft die erfasste Spanne aus der Eingabezeichenfolge ab.

(Geerbt von Capture)

Methoden

Name Beschreibung
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
NextMatch()

Gibt ein neues Match Objekt mit den Ergebnissen für die nächste Übereinstimmung zurück, beginnend an der Position, an der die letzte Übereinstimmung beendet wurde (am Zeichen nach dem letzten übereinstimmenden Zeichen).
Result(String)

Gibt die Erweiterung des übergebenen Ersetzungsmusters zurück. Wenn z. B. das Ersetzungsmuster lautet$1$2, Result(String) wird die Verkettung von Groups[1].Value und .Groups[2].Value
Synchronized(Match)

Gibt eine Match Instanz zurück, die der bereitgestellten Instanz entspricht, die sicher zwischen mehreren Threads gemeinsam verwendet werden kann.
ToString()

Ruft die erfasste Teilzeichenfolge aus der Eingabezeichenfolge ab, indem sie die Value Eigenschaft aufruft.

(Geerbt von Capture)

Gilt für:

Weitere Informationen