Udostępnij za pośrednictwem


Regex.GroupNumberFromName(String) Metoda

Definicja

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

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

Zobacz też