Freigeben über


Regex.GroupNumberFromName(String) Methode

Definition

Gibt die Gruppennummer zurück, die dem angegebenen Gruppennamen entspricht.

public:
 int GroupNumberFromName(System::String ^ name);
public int GroupNumberFromName (string name);
member this.GroupNumberFromName : string -> int
Public Function GroupNumberFromName (name As String) As Integer

Parameter

name
String

Der Gruppenname, der in die entsprechende Gruppennummer konvertiert werden soll.

Gibt zurück

Die Gruppennummer, die dem angegebenen Gruppennamen entspricht, oder -1, wenn name kein gültiger Gruppenname ist.

Ausnahmen

name ist null.

Hinweise

Ein Muster für reguläre Ausdrücke kann entweder benannte oder nummerierte Erfassungsgruppen enthalten, die Teilausdrücke innerhalb einer Musterüberstimmung abgrenzen. Nummerierte Gruppen werden durch die Syntax (Teilausdruck) getrennt und erhalten Zahlen basierend auf ihrer Reihenfolge im regulären Ausdruck. Benannte Gruppen werden durch die Syntax (?<Namen>Teilausdruck) oder (?' name'subexpression), wobei name der Name ist, mit dem der Teilausdruck identifiziert wird. (Weitere Informationen finden Sie unter Gruppierungskonstrukte.) Die GroupNumberFromName Methode identifiziert sowohl benannte Gruppen als auch nummerierte Gruppen anhand ihrer Ordnungspositionen im regulären Ausdruck. Ordnungsposition 0 stellt immer den gesamten regulären Ausdruck dar. Alle nummerierten Gruppen werden dann vor benannten Gruppen gezählt, unabhängig von ihrer tatsächlichen Position im Regulären Ausdrucksmuster.

Wenn name die Zeichenfolgendarstellung einer Gruppennummer ist, die im Muster des regulären Ausdrucks vorhanden ist, gibt die Methode diese Zahl zurück. Wenn name eine benannte Erfassungsgruppe entspricht, die im Regulären Ausdrucksmuster vorhanden ist, gibt die Methode ihre entsprechende Zahl zurück. Beim Vergleich mit name dem Gruppennamen wird die Groß-/Kleinschreibung beachtet. Wenn name nicht dem Namen einer Erfassungsgruppe oder der Zeichenfolgendarstellung der Anzahl einer Erfassungsgruppe entspricht, gibt die Methode -1 zurück.

Gilt für:

Weitere Informationen