Regex.GroupNumberFromName(String) Metoda
Definicja
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 -> intPublic Function GroupNumberFromName (name As String) As IntegerParametry
- name
- String
Nazwa grupy, która ma być konwertowana na odpowiedni numer grupy.
Zwraca
Numer grupy odpowiadający określonej nazwie grupy lub -1, jeśli name nie jest prawidłową nazwą grupy.
Wyjątki
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.