Regex.GroupNumberFromName(String) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí číslo skupiny, které odpovídá zadanému názvu skupiny.
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
Název skupiny, který se má převést na odpovídající číslo skupiny.
Návraty
Číslo skupiny, které odpovídá zadanému názvu skupiny, nebo -1, pokud name není platný název skupiny.
Výjimky
name je null.
Poznámky
Vzor regulárního výrazu může obsahovat pojmenované nebo číslovaný zachycené skupiny, které označují dílčí výrazy v rámci shody vzoru. Číslovanými skupinami jsou odděleny syntaxí (dílčí výraz) a jsou přiřazena čísla na základě jejich pořadí v regulárním výrazu. Pojmenované skupiny jsou oddělené syntaxí (?< Jméno> dílčí výraz) nebo (?' name'subexpression), kde název je název, kterým bude dílčí výraz identifikován. (Další informace naleznete v tématu Seskupování konstruktorů.) Metoda GroupNumberFromName identifikuje pojmenované skupiny i očíslované skupiny podle jejich pořadových pozic v regulárním výrazu. Pořadová pozice nula vždy představuje celý regulární výraz. Všechny očíslované skupiny se pak započítávají před pojmenovanými skupinami bez ohledu na jejich skutečnou pozici ve vzoru regulárního výrazu.
Pokud name je řetězcové vyjádření čísla skupiny, které je přítomné ve vzoru regulárního výrazu, metoda vrátí toto číslo. Pokud name odpovídá pojmenované zachytávání skupiny, která je přítomna ve vzoru regulárního výrazu, vrátí metoda odpovídající číslo. Porovnání name s názvem skupiny rozlišuje malá a velká písmena. Pokud name neodpovídá názvu zachytávání skupiny nebo řetězcové reprezentaci počtu zachytávání skupiny, vrátí metoda hodnotu -1.