Regex.GroupNumberFromName(String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce il numero di gruppo che corrisponde al nome di gruppo specificato.
public:
int GroupNumberFromName(System::String ^ name);public int GroupNumberFromName (string name);member this.GroupNumberFromName : string -> intPublic Function GroupNumberFromName (name As String) As IntegerParametri
- name
- String
Nome di gruppo da convertire nel numero di gruppo corrispondente.
Restituisce
Numero di gruppo che corrisponde al nome di gruppo specificato o -1 se name non è un nome di gruppo valido.
Eccezioni
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.
