Regex.GroupNumberFromName(String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> intPublic Function GroupNumberFromName (name As String) As IntegerParameter
- 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.
