Regex.GroupNumberFromName(String) Metodo

Definizione

Spazio dei nomi:

System.Text.RegularExpressions

Assembly:

netstandard.dll, System.Text.RegularExpressions.dll

Origine:

Regex.cs

Restituisce il numero di gruppo che corrisponde al nome di gruppo specificato.

C#

public int GroupNumberFromName(string name);

Parametri

name

String

Nome di gruppo da convertire nel numero di gruppo corrispondente.

Restituisce

Int32

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

Eccezioni

ArgumentNullException

name è null.

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