Regex.GroupNumberFromName(String) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Text.RegularExpressions

Zestaw:: System.Text.RegularExpressions.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zwraca numer grupy odpowiadający określonej nazwie grupy.

public:
 int GroupNumberFromName(System::String ^ name);

public int GroupNumberFromName (string name);

member this.GroupNumberFromName : string -> int

Public Function GroupNumberFromName (name As String) As Integer

Parametry

name: String

Nazwa grupy, która ma być konwertowana na odpowiedni numer grupy.

Zwraca

Int32

Numer grupy odpowiadający określonej nazwie grupy lub -1, jeśli name nie jest prawidłową nazwą grupy.

Wyjątki

ArgumentNullException

name to null.

Uwagi

Wzorzec wyrażenia regularnego może zawierać nazwane lub numerowane grupy przechwytywania, które delineują podwyrażenia w ramach dopasowania wzorca. Ponumerowane grupy są rozdzielane składnią (podwyrażeniem) i są przypisywane liczby na podstawie ich kolejności w wyrażeniu regularnym. Nazwane grupy są rozdzielane składnią (?< Nazwa> podyrażenie) lub (?") name'subexpression), gdzie nazwa jest nazwą, za pomocą której zostanie zidentyfikowane podwyrażenie. (Aby uzyskać więcej informacji, zobacz Grupowanie konstrukcji). Metoda GroupNumberFromName identyfikuje zarówno nazwane grupy, jak i grupy numerowane według ich pozycji porządkowych w wyrażeniu regularnym. Pozycja porządkowa zero zawsze reprezentuje całe wyrażenie regularne. Wszystkie ponumerowane grupy są następnie liczone przed nazwami grupami, niezależnie od ich rzeczywistej pozycji we wzorcu wyrażenia regularnego.

Jeśli name jest ciągiem reprezentującym liczbę grup, która znajduje się we wzorcu wyrażenia regularnego, metoda zwraca tę liczbę. Jeśli name odpowiada nazwanej grupie przechwytywania, która znajduje się we wzorcu wyrażenia regularnego, metoda zwraca odpowiednią liczbę. W porównaniu z name nazwą grupy uwzględniana jest wielkość liter. Jeśli name nie odpowiada nazwie grupy przechwytywania lub reprezentacji ciągu liczby grupy przechwytywania, metoda zwraca wartość -1.

Dotyczy