Match Klasa

Definicja

Przestrzeń nazw:

System.Text.RegularExpressions

Zestawy:

netstandard.dll, System.Text.RegularExpressions.dll

Źródło:

Match.cs

Reprezentuje wyniki z jednego dopasowania wyrażenia regularnego.

public ref class Match : System::Text::RegularExpressions::Group

public class Match : System.Text.RegularExpressions.Group

type Match = class
    inherit Group

Public Class Match
Inherits Group

Dziedziczenie

Object

Capture

Group

Match

Uwagi

Klasa Match jest niezmienna i nie ma publicznego konstruktora. Wystąpienie Match klasy jest zwracane przez metodę Match(String) i reprezentuje pierwsze dopasowanie wzorca w ciągu. Kolejne dopasowania są reprezentowane przez Match obiekty zwracane przez metodę NextMatch() . Ponadto MatchCollection obiekt składający się z zera, jednego lub większej liczby Match obiektów jest zwracany przez metodę Matches(String) .

Matches(String) Jeśli metoda nie pasuje do wzorca wyrażenia regularnego w ciągu wejściowym, zwraca pusty MatchCollection obiekt. Następnie można użyć foreach konstrukcji do iterowania kolekcji.

Match(String) Jeśli metoda nie pasuje do wzorca wyrażenia regularnego, zwraca Match obiekt, który jest równy Empty. Możesz użyć Success właściwości , aby określić, czy dopasowanie zakończyło się pomyślnie.

Jeśli dopasowanie wzorca zakończy się pomyślnie, Value właściwość zawiera pasujący podciąg, Index właściwość wskazuje położenie początkowe na podstawie zera dopasowanego podciągu w ciągu wejściowym, a Length właściwość wskazuje długość dopasowanego podciągu w ciągu wejściowym.

Ponieważ pojedyncze dopasowanie może obejmować wiele grup przechwytywania, Match ma właściwość zwracającą Groups wartość GroupCollection. Samo Match wystąpienie jest równoważne pierwszemu obiektowi w kolekcji , Match.Groups[0]który reprezentuje całe dopasowanie.

Właściwości

Nazwa	Opis
Captures	Pobiera kolekcję wszystkich przechwytywania dopasowanych przez grupę przechwytywania w kolejności najdalej po lewej stronie (lub najbardziej wewnętrznych z prawej do prawej kolejności, jeśli wyrażenie regularne jest modyfikowane za pomocą RightToLeft opcji ). Kolekcja może zawierać zero lub więcej elementów. (Odziedziczone po Group)
Empty	Pobiera puste dopasowanie. Wszystkie nieudane dopasowania zwracają to puste dopasowanie.
Groups	Pobiera kolekcję grup dopasowanych przez wyrażenie regularne.
Index	Pobiera pozycję w oryginalnym ciągu, w którym znajduje się pierwszy znak przechwyconego podciągu. (Odziedziczone po Capture)
Length	Pobiera długość przechwyconego podciągu. (Odziedziczone po Capture)
Name	Zwraca nazwę grupy przechwytywania reprezentowanej przez bieżące wystąpienie. (Odziedziczone po Group)
Success	Pobiera wartość wskazującą, czy dopasowanie zakończyło się pomyślnie. (Odziedziczone po Group)
Value	Pobiera przechwycony podciąg z ciągu wejściowego. (Odziedziczone po Capture)
ValueSpan	Pobiera przechwycony zakres z ciągu wejściowego. (Odziedziczone po Capture)

Metody

Nazwa	Opis
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
NextMatch()	Zwraca nowy Match obiekt z wynikami następnego dopasowania, zaczynając od pozycji, w której ostatnie dopasowanie zakończyło się (na znaku po ostatnim dopasowanym znaku).
Result(String)	Zwraca rozszerzenie przekazanego wzorca zastępczego. Jeśli na przykład wzorzec zastępczy to $1$2, zwraca łączenie Groups[1].Value wartości i Groups[2].ValueResult(String) .
Synchronized(Match)	Match Zwraca wystąpienie równoważne podanemu, który jest bezpieczny do współużytkowania między wieloma wątkami.
ToString()	Pobiera przechwycony podciąg z ciągu wejściowego, wywołując Value właściwość . (Odziedziczone po Capture)

Zobacz też

• MatchCollection
• Regex