Regex.GroupNumberFromName(String) Metodo

public:
 int GroupNumberFromName(System::String ^ name);

public int GroupNumberFromName (string name);

member this.GroupNumberFromName : string -> int

Public Function GroupNumberFromName (name As String) As Integer

Parametri

Restituisce

Numero di gruppo che corrisponde al nome di gruppo specificato o -1 se name non è un nome di gruppo valido.

Eccezioni

Commenti

Un criterio di espressione regolare può contenere gruppi di acquisizione denominati o numerati, che delineano sottoespressioni all'interno di una corrispondenza dei criteri. I gruppi numerati sono delimitati dalla sintassi (sottoespressione) e vengono assegnati numeri in base all'ordine nell'espressione regolare. I gruppi denominati sono delimitati dalla sintassi (?<Nome>sottoespressione) o (?' name'subexpression), dove name è il nome in base al quale verrà identificata la sottoespressione. Per altre informazioni, vedere Costrutti di raggruppamento. Il GroupNumberFromName metodo identifica sia i gruppi denominati che i gruppi numerati in base alle rispettive posizioni ordinali nell'espressione regolare. Posizione ordinale zero rappresenta sempre l'intera espressione regolare. Tutti i gruppi numerati vengono quindi conteggiati prima dei gruppi denominati, indipendentemente dalla posizione effettiva nel criterio di espressione regolare.

Se name è la rappresentazione di stringa di un numero di gruppo presente nel criterio di espressione regolare, il metodo restituisce tale numero. Se name corrisponde a un gruppo di acquisizione denominato presente nel modello di espressione regolare, il metodo restituisce il numero corrispondente. Il confronto tra name con il nome del gruppo fa distinzione tra maiuscole e minuscole. Se name non corrisponde al nome di un gruppo di acquisizione o alla rappresentazione di stringa del numero di un gruppo di acquisizione, il metodo restituisce -1.

Si applica a

Vedi anche

• GroupCollection
• GetGroupNames()
• Costrutti di raggruppamento nelle espressioni regolari