Regex.GroupNumberFromName(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna o número do grupo que corresponde ao nome do grupo especificado.
public:
int GroupNumberFromName(System::String ^ name);public int GroupNumberFromName (string name);member this.GroupNumberFromName : string -> intPublic Function GroupNumberFromName (name As String) As IntegerParâmetros
- name
- String
O nome do grupo a ser convertido para o número de grupo correspondente.
Retornos
O número do grupo que corresponde ao nome do grupo especificado ou -1 se name não for um nome de grupo válido.
Exceções
name é null.
Comentários
Um padrão de expressão regular pode conter grupos de captura nomeados ou numerados, que delineam subexpressões dentro de uma correspondência de padrão. Os grupos numerados são delimitados pela sintaxe (subexpressão) e são atribuídos números com base em sua ordem na expressão regular. Os grupos nomeados são delimitados pela sintaxe (?< Nome> subexpressão) ou (?' name'subexpression), onde o nome é o nome pelo qual a subexpressão será identificada. (Para obter mais informações, consulte Construções de agrupamento.) O GroupNumberFromName método identifica grupos nomeados e grupos numerados por suas posições ordinais na expressão regular. A posição ordinal zero sempre representa toda a expressão regular. Todos os grupos numerados são contados antes dos grupos nomeados, independentemente de sua posição real no padrão de expressão regular.
Se name for a representação de cadeia de caracteres de um número de grupo presente no padrão de expressão regular, o método retornará esse número. Se name corresponder a um grupo de captura nomeado presente no padrão de expressão regular, o método retornará seu número correspondente. A comparação com name o nome do grupo diferencia maiúsculas de minúsculas. Se name não corresponder ao nome de um grupo de captura ou à representação de cadeia de caracteres do número de um grupo de captura, o método retornará -1.